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RS-232° 


Three powerful tools for programming asynchronous communications 
The Grunt Work done — by Greenleaf 


NEW C Version! 


Greenleaf CommLib 
Level 2™ Version 3.2 


NEW SUPPORT - Phar Lap 
286 | DOS-Extender, Rational 
DOS/16M. 


Device independent function 
calls supported by twelve 
drivers — support intelligent 
and standard multiport boards 
and/or FOSSIL drivers. 


XMODEM, YMODEM (Batch), 
ZMODEM (Batch), Kermit, 
ASCII file transfers. 1K, G, 
CRC options. 


Access modems via network 
using Fresh Technology 

MODE Assist™ or CDS 
Sparkle program. 
XON/XOFF, RTS/CTS and 
DTR/DSR flow controls. 


Up to 115,200 baud. 8250, 
16450 UART, and 16550 FIFO 
modes. Ring-buffered, all four 
interrupts serviced. Buffers to 
65K. Fast receive interrupt 
option for tight spots. 


e Unlimited number of ports 
for all popular multi-port boards 
including DigiBoard, StarGate 
and Arnet. 


e More than forty modem control 
functions. 


* Includes keyboard functions, 
Ctrl-Break Handler, unique 
WideTrack™ Receive feature. 


If you are seriously contemplating 
writing an application that uses interrupt 
driven asynchronous routines, you 
specie can’t go wrong with 

CommLib from Greenleaf Software." - 
Telecomputing Magazine 

Greenleaf CommLib is the smoothest 
toolkit lown. OUTSTANDING’ sums it 
up!" - Larry Dalton 

When developing communications 
software, there often comes a time when 
your software just doesn’t quite work and 
itcan be devilish to divine just what the 
problem is. Greenleaf has a simple, 
inexpensive, and remarkably effective | 
solution. The product is ViewComm." - 
Boardwatch Magazine 


NEW C++ Product! 


™ 


++ 


Debugging Too!! 


Greenleaf ViewComm™ 


Greenleaf Comm 


True C--Class Library. Data Line Monitor - Full 


e Device Independence through featured RS-232 “Datascope” 
Inheritance. runs on your PC or Laptop. 
S ts Zortech B e Monitor, Capture Data in 

‘Coeds ASCII, EBCDIC, Baudot to 


115,200 baud. 


e Capture to buffer or file, 
Review, String Search. 

e Unlimited Triggers on Modem 
Status, Data Patterns, 
including wildcards. 

e View Data in Hex, Octal, 
Decimal, Binary, with Graphic 
Characters for Control Codes. 

e Timestamps, Variable Resolution, 
for each character, down to 1 msec. 

e Source Mode lets you send 
from file, keyboard or both. 

e File format & include files 
provided so you can analyze 
captured data. 

e ViewComm will pay for itself 

the first time you use it. 


e DOS, OS/2, Windows. 

e IBM PC, XT, AT, PS/2 and 
Compatibles. 

e COM1..COM4. 

e Baud Rates to 115,200. 

e XON/XOFF, RTS/CTS Flow 
Controls. 

e XMODEM, Kermit File 
Transfer Protocols. 


e VT52, VT100 subset, ANSI 
Terminal Emulation plus TTY 
Emulation. 


e Hayes Modem Control Classes. 


e Line and Link Level Controls 
& Status. 


e Extensive Examples help you 
get started. 


All Greenleaf Libraries Come With: 


/ Free Source Code, Free Tech Support, Free BBS, Newsletter, Reference Guide 

¥ Online Documentation System for MS Advisor, Norton, PDQPlus (With engine) 

/ Top Rated Documentation 

¥ Support all major C and C-+-compilers for DOS 

/ Exclusive Gold Support Card support available (Extra charge) guarantees upgrades 
shipped automatically, plus 800-numbers for Tech Support and 9600 baud BBS. 

/¥ No Royalties, Money-Back Guarantee, of course. 


® Call today for complete information, 
demo or to order. MasterCard, VISA, 
AmEx, approved Purchase Orders. 


Greenleaf CommLib v3.2 $359 
Greenleaf Comm+-v1.0 $199 
Greenleaf ViewComm v3.0 $399 


1-800-523-9830 
214-248-2561 FAX 214-248-7830 
BBS (Free Demos) 214-250-3778 
Greenleaf Software Inc. 


16479 Dallas Parkway, Suite 570 
Dallas, TX 75248 
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“Tcan't believe it’s not UNIX.” 


Take it from the critics, Coherent 
is so close to UNIX, you won’t 
believe your eyes. Or the price. 
“Mark Williams Co. seems 
to have mastered the art 
of illusion; Coherent comes 
so fully qualified as a UNIX 
clone, you find yourself thinking 
‘I can’t believe it’s not UNIX? ” 
—Sean Fulton, UNIX Today!, 
November 26, 1990 
“..(Coherent) may be the best thing 
that has happened to UNIX yet.” 
—-William Zachmann, PC Week, 
November 5, 1990 
“If you want to come as close as you 
can to real UNIX for a low price, 
COHERENT can’t be beat.” 
—Warren Keuffel, Computer Language 
Magazine, November 1990 
“If you want a UNIX-like develop- 
ment and learning system for less 
than $100...I don’t see how you can 


go wrong with Coherent.” 
—David Fiedler, BYTE Magazine, 
November 1990 


OVER 30,000 USERS, 
AND MORE EVERY DAY! 


Why is Coherent now the 
world’s best-selling UNIX clone? 


MWC sco 
COHERENT XENIX 286 
Version 3.2 Version 2.3.2. 


No. of Manuals 

No. of Disks 

Kernel Size 198K 
Install Time 20-30min. 34 hours 


Suggested Disk Space 10 meg 30 meg 
Min. Memory Required 640K 1-2 meg 
Performance® 38.7sec 1003 sec 
Price $99.95 $1495.00 


“Byte Exec! benchmark, 1000 iterations on 20 MHZ 386. 
Hardware requirements: L2 meg 5¥4° or L4 meg 3¥2" floppy, 
and hard disk. 


NEW RELEASE 3.2 


$99.95" 


Because like the original UNIX, 
Coherent is a powerful, multi-user, 
multi-tasking development system 
with a complete UNIX-compatible 
kermel and C compiler. 

Features include Lex and Yacc, 
a vi editor, SCSI support and UUCP 
capabilities. 

And Coherent comes with a full 
set of over 200 UNIX commands 
including text processing, program 
development, administrative and 
maintenance functions. All of it fully 
documented in our highly acclaimed 
1200 page manual. 

WHAT UNIX WAS MEANT TO BE. 

Unlike current versions of 
UNIX, Coherent is lean and efficient. 
Small and beautifully powerful, the 
way UNIX was originally designed. 

Coherent runs on affordable 
286 as well as 386 and 486 based 
IBM-PCs and compatibles with 
space to spare. Enough space to keep 
DOS co-residing on your hard disk. 

And it’s so fast to install, so fast 
to learn and just so fast, Coherent 
leaves UNIX in the dust. 


Sean Fulton, UNIX Today! 


HARD TO BELIEVE? 
TT KEEPS GETTING BETTER. 
Like Coherent, all Mark 
Williams products are incredible 
values. Including regular updates 
with new and enhanced features. Our 
write-your-own device driver kit. 

And COHware, contributed software 

on diskette. 

There’s also on-going free tech- 
nical support via telephone. An 
active user network and a UUCP 
Bulletin Board System. Plus, with 
our new 3.2 release: 
¢ Anew Korn shell with sophisti- 

cated command-line editing. 

* Postscript and PCL support for 
troff adding access to hundreds of 
new fonts. 

* Improved UUCP support. 

* International keyboard and 
character set support. 

TAKE 60 DAYS TO 
CONVINCE YOURSELE 

Will you agree with the critics 
and Coherent’s 25,000-plus users? 

Try it. And if you don’t think 
Coherent is everything you ever 
wanted in UNIX, we'll refund your 
money. No problem. No hassle. 

You can’t go wrong. So get to 
a phone, FAX or mailbox now and 
order Coherent today. At $99.95, 
it’s unbelievable. 


1-800-MARK WMS 
(1-800-627-5967 or 1-708-291-6700) 
FAX: 1-708-291-6750 
60-DAY MONEY BACK GUARANTEE! 


OY exe 


60 Revere Drive 
Northbrook, IL 60062 
ee Ape dey and handling. Cobercal is a trademark of 


Meals a trademark of AT& 
eeemerinat eg af Mocreochi oem TEND 


Distributors: Australia (07) 266-2270, Czechoslovakia 632-62877, Denmark 42-88-72-49, Finland 47-871-201, France MS 46-72-80-74, 
Germany (0511) 53-72-95/(030) 313-7015, Norway 211-0950, Singapore 336-0188, Sweden (0) 660-192-90 
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C CODE FOR THE PC 


source code, of course 


NEW! DBAPrep (embedded SQL to C translator; supports Oracle, Sybase, SQL Server, XDB, Novell XQL, SQLBase, and QH-lib) . 2... $1,500 
Virtual Memory Objects (birees, lists, arrays, and other multiple memory classes in heap, EMM, and swap file; no royalties)... 2. . . . $750 
Embalded DOS (full-features, real-time, multitasking, 3.31-compatible DOS for embedded system and self-bootabic installations) . . . . . $375 

,, Spell Time (spelling checker for incorporation into text products; no alty; large dictionary; small and fast)... 1... 2. «+ « + $300 

NEW! Imaging Objects (C++ object library for imaging, PCX & TIFF, convofutions, print with dither, diffusion & paltioncs) Ree ae ee $290 
ZIP Image Processor & Victor Image Library Version 2.0 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 
Meijin+ + (C++ class Non for modcling & simulation; queucs, statistical tools, fourier transforms, differential equations; no royaltics) . . $255 
‘Turtwll:X (Release 3.0; HP, PS, dot drivers; CM fonts; LaT&X; MetaFont) ......-..- Ss tS das CSP AB BE sl WH. 8 wns Se Katee o> ee oe Beek 250 

sear, Rogue Wave tools.h+-++ or math.h+-+ Class a Draty kexleneiys GCS) 25, e bbe eee, wae wR, Ge tH ae a a Ba BOGS) See. we wi tia each $240 

NE i ! PASQL (SQL. for Borland’s Paradox Engine; ANSI X3.135-1989 SQL-DML standard; network server notrequired). ........--. $180 

NEW! Embedded DOS Utility SDK (C source for standard DOS utilitics — FDISK, FORMAT, COMMAND.COM andeight more)... 2... $170 
are (PostScript generation library for C programs; includes complete graphics, font, rotation & paragraph support. . 2. 2... « $170 

<S Library Version 2.01 (C program interface to Lotus 1-2-3, dBase, Supercalc 4, Quatro, & Clipper) 2... 1 ee ee . $155 

Empty Shell (run a program in an omnpy DOS shell; written in assembler for speed and small size; Ccallinterfacec). . . 2... ...2.. $150 

. Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25" or 3.5" diskettes) . 2 2.2... 1. each $150 
Upda ted! Deloric GCC for MS-DO! ersion 1.05; includes C++, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 
Heap ander (Version 3.0, virtual memory manager using expanded memory, extended memory and disk; XMS, VCPI,LIM) ..... . $135 

CBirce (8-+tree ISAM driver, multiple variable-length keys) 6 6 we ee $135 

TE Editor Developer's Kit (full screen editor, undo command, multiple windows; with word processing: $195; Windows 3.0: $200) ..... $130 

XMEM (cxtended and expanded memory manager, written in assembler with C call interface; swaps to disk; smalland fast)... ..... $130 

Booter Toolkit (floppy disk bootstrap routines, DOS file system, light-weight multitasking, windows, fast memory management) ...... $120 

WinMem (unlimited global memory handles for Windows 3.0, 4-byte overheadper block rather than 20, virtual memory for 286) ...... $110 

CSIM (discrete event simulator library; clocks, chains, future events, multiple servers, queues, reports)... 2 2. ee ee et ee $100 


Hceapman (application memory management for Windows 3.0, 64K bytes of hcap space; includes memory browser/debugger) ....... 100 

SZ Theve (Novell Btrieve access with data dictionary and data manager, noroyalties) 2... ee ee $100 

NEW! EzBase (C interface to dBase files; create, read, write & update .DBF and .DBT, includes indexsupport). .. 2... 2... ee ee $100 

CDB for DOS & Unix (database toolkit; ISAM, DDL, relational & network, space reuse, concurrent access; fast, no royalty)... . 2... $95 

Kier FinanceLib (interest, conversions, annuities, depreciation, cash flow, bonds,elc) . 2... 2. tt ee $95 

PowerSTOR (Version 1.2; extended heap space on extended memory, expanded memory, and/or harddisk)... 2... 2 wee eee $95 

Script Interpreter (a command script interpreter for DOS-based systems; C-like script language; lotsoffeatures). . 2... ....040. $90 

Visions 1.20 (text window user interface management haba includes mouse support and background processing)... ......... $80 

VMEM (virtual memory manager by Blake McBride, Version 3.6, PU Peet dynamic swap file, image save/restore). . .... 2.2... $80 

cbase (C database library, sequential & b+-tree random access, buffered block I/O, file-level font) ae 0 ge ae eho xo Mer es ae i Hort DY SE ES $75 

TrecDraw (PostScript display of labeled hierarchical trees; DOS & Windows screen display included; Moenalgorithm) .......... $75 

FinanC (large collection of financial function including bond, inventory, stock portfolio, & cashflow). 2... 2. eee $70 

FlexList (doubly-linked lists of arbitrary data with sultipte access methods; specifyCorC++) ......... 0.2... 2004 each $65 

Foundations-1 C++ Class Library (ASCII record I/O, bit arrays, exception handling, B-tree, persistent objects) . . 2... 2... 2.2.00 $60 

NEW! LDB (Loose Data Binder, persistent data objects for C+ +; handles pointers between objects) 2 6. 2 ee $60 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic) ... 2... 1... ee ee ee eee $60 

Coder’s Prolog (Version 3.0, inference engine for use with C programs) . . 2 2. 2 1 ee ee $60 

MEM_WING (global memory manager for Windows, supports standard C memory allocation calls to “wing” your old C code into Windows) . $55 

Mini ap ed generator for complex data; single inheritance, translator & table generator tools, ASCII external form only)) . . . . . $50 

CALC (ASCII algebraic expression evaluator, unlimited parentheas nesting, symbols, 32 built-in functions, easilyextended) . . . . 2... $50 

Backup & Restore Utility by Blake McBride (multipte volumes, file compression & encryption)... 1 1 ee ee $50 

Floppy TAR (TAR backup and restore on MS-DOS devices; direct access to non-standard devices) 2 6. 1 ee ee et $50 

Supe ene (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories)... 2... 1 eee ee ee $50 

oO M (convert .obj files to .asm files; output is MASM compatible) . 2... ee ee $50 

CLIPS Version 5.0 (rule-based expert system generator, advanced manuals available at additional cost So siih sp Bal os fay ee Ye, Bs ay east 50 

NIH Cass Library & Book (basic C+-+ classes & Data Abstraction and Object-Oriented Programming in C + + in softback by Keith Gorlen) $50 

Editor Pack (15 public domain editors; including microEmacs 3.11, Stevie, Elvis, Moke, mg2a, DTE, Jove, & Origami) .......... 50 

NEW! MicroC C Compiler (retargetable C compiler with optimizer, libraries, and utilities; lots of docs, very portable, tables for Scpu's). . . .. . $50 

NEW! JOUR eecull ul traveling salesman problem solver, finds minimum length paths quickly, includes graphics & plotting programs) ..... $40 

UNE NCSMPIelen): cesses ey 5, sah oie ak Se, hy > Be ae tes Oe Raat, es Gee eee Rt, LHS SSinhiceh aor Be co MS a Wah, oh Ua GaSe: Se a OS IH 8 $40 

DES fn tion & peop (2500 bits/second on 4.77 MHz PC for on-the-fly encryption at 2400 baud; domestic distribution only) . . . . $40 

RXC & EGREP Version 20 (Regular Expression onl and Pattern Matching; finite state machine from regular expression) ..... . $35 

Database Pack (9 databases — simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres) . . 2. 2 1 ee ee ee $35 

Bison & BYACC (YACC workalike parser generators; documentation; no restrictions on use of BYACC output) . . 2... eee ee ee $35 

Object-Oriented Programming in C++ (code from the book by Naba Barkakati) © 2 6 2 1 6 ee ee $30 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) . . . . $30 

GX Plus (Version BO search and replace string manipulation routines based on regularexpressions) . 2. 6 2 1. ee ee ee es $30 

GNU Awk & Diff for PC (both programs in one package) «©... ee ee ee $30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter isincluded) ....... $30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP) .. 2... ee ee ee eee ee $30 

Updated! UUPC Pack (UUCP for the PC; UUPC Version 1.11Q by Wonderworks and smail/PC Version 2.5 by Stephen. Ther)... .....-. $25 

PERL for MS-DOS (C, sed, awk, and shell all rolled into one language; includes hardcopy docs)... . . 1 1 ee ee ee ee ee $25 

Updated! Te Version 6.1 (Tool Command Language; add shell ore ramming capability to any command Jine; elegant command line language) . .. - $25 

FLEX (fast lexical analyzer generator, new, improved LEX; BSD Version 2.3.6 with docs) 2. 6 1 6 ee ee $25 

Livermore Loops in C (the famous Fortran benchmark transliterated to C; includes technical report as PostScriptfile) .........-. $20 

XLISP 2.1 (includes Almy improvements) . 2. 1 6 1 ee ee ee ee $20 

GNU RCS (FSF's version of the Revision Control System; like Unix’s SCCS only better, keeps track of software development)... ... - $20 

Gperf Version 2.5 (GNU's perfect hash table generator, requires DJ goc; includes executable; specifyCorC++) .....-...--- each $20 

SDBM (fast, disk-based hash table manager for really large hash tables; clone of Unixndbm) . . . . - 6 0 ee ee ee ee $20 

NEW! PCAL Personal Calendar (generates PostScript calendar for any month or year, lots of options, personalization file for your dates & schedule) $20 
Data 

Moby Thesaurus (25K root words, 1.2M synonyms; requires signed license agreement) . 2. 6 6 6 ee ee ee ee ee et $350 

Moby Part-of-Specch (200,000 words and phrases described by prioritized part(s)-of-speech) ©... ee eee ee es $120 

Moby Words (500,000 words & phrases, 9,000 stars, 15,000names) 2. 2 1. ee ee ee $80 

Moby Shakespeare (plays, sonnets, etc. .. everylastword) . 2... 2 ee ee te es $60 

Dictionary Word List (234,932 words in alphabetical order) 2... 1 1 1 ee te ee ee $60 

Roget's 1911 Thesaurus: fe. a ietisa.  iay 6e be ie Se HR NEE NS EDS) Bia Re oe WS Hi ee tw Um TR SR ne DS $40 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points). © 2. 1 ee ee $35 

NEW! CIA World Bank If Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; Africa, Asia, Europe, N. &S. America) . $35 

The World Digitized (100,000 longitude/latitude of world country boundaries) «1 1 1 1 ee et $30 

Lots 'O Words (160, German, 178,430 Dutch, 61,843 Norwegian, 60,453 Italian, 138,257 French, 53,142 English) . . 2... 2-2 e+ $30 

Updated! ‘Text Pack (1990 CLA World Fact Book, Hacker’s Jargon File, Acronym List, Koran, Mormon Scriptures) . 2... 2 eee eee es $25 

Dan Klein's Dictionaries (53,091 words and phrases in 25 dictionaries). 2 2. 1. 1 1 1 ee ee ee ee ee et $20 

The Austin Code Works Voice: (512) 258-0785 

11100 Leafwood Lane much more ... ask for catalog FAX: (512) 258-1342 

Austin, Tezas 78750-3587 USA E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA 
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Get Inside WINDOWS! ' - 


MICROSOFT: 
WINDOWS 


Vira WO Cargetdite Prabet 


Debug Windows at the systems level! 


Soft-ICE/W takes you inside Windows! Debug and explore with power 
and flexibility not found in any other Windows debugger! Soft-ICE/W 
allows you to debug at the systems or applications level or simply learn 
the inner workings of Windows. 
e Debug VxD's, drivers and interrupt routines at source level 
e Debug interactions between DOS T&SR's and Windows Apps 
e Debug programs in DOS boxes 
e Display valuable system information 
(from the total memory occupied by a Windows application, to the 
complex internal structures of Windows) 


Soft-ICE/W uses the 386/486 architecture to provide break point 
capabilities that normally require external hardware. Nu-Mega, which 
pioneered this technology with the introduction of its award winning 
Soft/ICE for DOS, now gives Windows programmers the same debug- 
ging power... and still at a software price. 


Own the debugger that combines the best “view” of Windows internals 
with the most powerful break points of any software debugger. 


Soft-ICE/W . .. Only $386 


CodeView for Windows users: see what you're debugging without flash. 
CV/1 version 2.0 runs CodeView in a graphics window while viewing your 
application screen. Runs on any display that supports Windows. 


CV/1... Only $129 


Buy any Nu-Mega product and get CV/1 for only $69. 


Cal: (603) 889-2386 & RISK = NULL 
Fax: (603) 889-1135 NueM 30 DAY 
P.0i:'B PDEA ETRTIAT CAT own 
Nashua, NH sere U.S.A. TECHNOLOGIES INC i 


MICROSOFT WINDOWS IS A REGISTERED TRADEMARK OF MICROSOFT CORP. —Solt-ICE\W AND CV’1 ARE TRADEMARKS OF NU-MEGA TECHNOLOGIES, INC. 
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WHAT THE EXPERTS ARE SAYING 


“Soft-ICE for Windows Is great! It helped me 
find, in fifteen minutes. a killer bug in a 
Windows virtual device driver that had 
eluded two people for several months. | 
can't see doing Windows development of 
any kind — whether writing Windows 
applications, device drivers, or even DOS 
programs that have to mun under Windows — 
without it. In addition to being great for 
finding bugs, Soft-ICE for Windows has been 
essential for my work on a forthcoming book: 
on Undocumented Windows. Soff-ICE for 
Windows goes anywhere and does 
everything. so it's essential for anyone who 
wants to poke around inside Windows 
Enhanced mode. DOS programmers will find 
it o perfect way to leam how the Windows 
DOS extender and DPMI server work, and 
how Windows Interacts with DOS. Windows 
Enhanced mode is the hacker's paradise of 
the 90s, and Soft-ICE for Windows is the tool 
that every serious Windows or DOS hacker 
will iis Nu-Mega has done a brilliant 
job!" 


Andrew Schulman 


Software Engineer, Phar Lap Software 
Editor. ni 


Coauthor, Undocumented Windows (forthcoming) 
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The Users Journal” 


USER INTERFACES 


Porting Command Line User Interfaces to GUIs By William Smith . . 2. . . 2... we SD 
Sometimes it pays to do the user interface last. 


A Versatile Menu Program for Turbo C By Roger T. Stevens . . Sh ee eh eS eae we Be 
This system allows users to supply interactive input when selecting an option. 


OTHER FEATURES 


Multiple Copy Math Functions By Dr. Timothy Prince 
Vector chunk math functions exploit parallelism to maximize potential. 


Yet Another C++ Money Class By Adolfo DiMare : 
Exploit the power of advanced hardware by writing functions that produce 
multiple results. 


Lexical Analysis Using Search Tries By John W. M. Stevens . 
This special type of tree is a good fit for language translation applications. 


COLUMNS 


Standard C  P. J. Plauger 

Doctor C’s Pointers Rex Jaeschke 
On The Networks Sydney Weinstein 
Questions & Answers Ken Pugh 
CUG NewReleases Kenji Hino 


Photo by Robert Ward. 
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C Express: 250+ Ready-To-Run Assembly Language Routines for New Products 


Turbo C, Microsoft C, and QuickC WeHave Mail . . . . 122 
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EVE CHARTED 
THE WAY — 
WITH WIN++ 


cool OF Wine WIS @ppltcatie qe 
“* in Borland €4e4 ‘ 


We've chosen the direction and plotted the course to easy 
and powerful Windows applications development! 


Now with over 150 classes, Win++™ provides a simplified, flexible 
and powerful high-level C++ interface to make your Windows development 
efforts a breeze. Classes for setting internal data structures and integrating data 
into applications are also included. 


Put the wind at your back... 


Central to Win++ is that it provides a class for each type of display object in 
Windows. Win++ includes ready-made classes for representing dialog boxes, child controls, pens, 
brushes, menus, bitmaps, cursors, icons, a printer, a clipboard, and many others. New classes 
support the dynamic data exchange management library (DDEML), including clients, servers, 
advise loops and multiple simultaneous conversations. Win++ also supports the construction of 
dynamic-link libraries (DLLs). Use Win++’s ready-made DLLs in your programs and save valuable 
time, memory and disk space. And, you may distribute Win++'s DLLs with your applications. 


ae 4 & 


Win++ comes with a comprehensive reference manual and tutorial. Complete source code is included. 
You can rely on Blaise Computing to provide and support quality add-on libraries. We’ve been doing so 
since 1982 — it’s our business — our only business. 


Win++ requires Windows 3.0 or later and Borland C++. Win++ costs just $289. We're so 
convinced that you'll find Win++ essential to your applications that if during the first 60 
days you're not completely satisfied, we'll refund your money. No questions asked. 


Call our order department toll free at (800) 333-8087! Or. by fax, (510) 540-1938. 
Ask about training and consulting services! 


BLAISE COMPUTING INC. 


ee 
819 Bancroft Way Berkeley. California 947K) (S100 540-44] 
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Editor’s Forum 


I have been thinking a lot about standards lately. That should be no 
surprise, since I write about standards a lot. Still, my perspective has been 
shifting lately. 


When I got involved in the C standard back in 1983, the world was dif- 
ferent. Most of us compiler vendors cared intensely about forming a good 
standard. Many of our potential customers had a different focus. They were 
more concerned that we didn’t mess up a language they had come to depend 
on. Experience with other major programming language standards was not 
encouraging. Delays, excess invention, even litigation seemed to be par for 
the course. 


C helped usher in a new era. Here was a standard being formed by active 
representatives from a broad community. No single vendor dominated the 
proceedings, nor did a small clique of language inventors. Here was a stand- 
ard with widespread commercial support from the outset. 


And that’s what has become the norm. Computing is a big and very com- 
petitive business. Complying with standards is of interest to more than just 
government contractors. The world can’t afford bad standards any more. So 
everyone seems to have something to say about programming standards 
now. 


Even more interesting, programming standards have become a serious 
matter in the international community. With the growth in international 
trade, everyone wants a level playing field. Having serious international 
standards helps the small players compete with the larger ones. It also helps 
the larger players meet the needs of the smaller markets. 

Both ANSI and ISO are scrabbling to adapt to this new state of affairs. 
The volume of commentary and the pressure to develop timely standards 
keeps growing, even as the standards become more complex. I don’t see how 
they are going to change fast enough, but I know that they must. 


PJ. Plauger 
pjp@plouger.uunet 


hm 


P.J. Plauger 
pjp@plauger.uunet.uu.net 
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Kills bugs dead. 
Keeps bugs away. 


Slash Development Time. 

This year and next, C programmers are going to 
spend millions of hours looking for memory 
allocation errors. What a shame. Tens of thousands of 
product dates will slip, and hundreds of thousands of 
aspirin will be taken. Finally, there’s a solution that 
doesn't involve changing a single line of code. 


Meet Your New Watchdog. 

MemCheck is an error detection and prevention tool 
that helps C developers reduce development time and 
meet application reliability standards. MemCheck will 
find memory leakage, buffer overwrites, and other 
nasties with reports that identify the exact location of 
the culprit. Quickly. Automatically. Painlessly. 


Greater Certainty. 

Whether you're bitten by bugs or just want to make 
sure none are “hiding,” MemCheck is the easiest 
addition you can make to your software development 
environment. MemCheck integrates seamlessly with 
existing C code, with versions that are custom-tailored 
for all major compilers. Just plug and play — no 
hassles, no rough edges. 


Industrial Strength. 

Up your Quality Assurance standards. Find your 
toughest C bugs. Join the ranks of the major developers 
who have discovered MemCheck. No product adds so 
much value with so litte effort. Find out why 
MemCheck is setting standards in software reliability. 


= Menggfeck: 


EFFORTLESS ERROR DETECTION AND PREVENTION 
To order, call (313) 996-2944 


Suggested retail prices: Microsoft C $139.95, Borland C $139.95, Intel Code Builder $179.95, Watcom C $179.95. Windows SDK $179.95 
All major credit cards accepted. Fax orders welcome: (313) 747-8519. Please specify compiler and diskette size. 
STRATOSW'ARE CORPORATION Suite 1500, 1756 Plymouth Read, Ann Arbor, ME aR 10s 
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P.J. Plauger 


The Header <stdlib.h> 


Introduction 


The header <stdlib.h> is a 
hodgepodge. Committee X3J11 in- Standard C a 
vented this header as a place to define | | fs & 
macros and declare functions that had 
no other sensible home: 

* Many existing functions, such as 
abs and malloc, had no traditional 
headers to declare them. X3J11 felt 
strongly that every functions should 
be declared in a standard header. If 
such a function seemed out of place 
in all other headers, it ended up 
declared in <stdlib.h>. 

¢ New groups of macros and func- 
tions ended up in new standard 
headers wherever possible. 
<float.h> and <locale.fA> are 
clear examples. Additions to exist- 
ing groups ended up in existing 
headers. strcoll, declared in 
<string.h>, and =  “strftime, 
declared in <time.h>, are also fairly 
clear. Other macros and functions 
are harder to categorize. These 


To provide some structure, I or- 
ganize the functions into six groups: 

* integer math (abs, div, labs, and 
Idiv) — performing simple integer 
arithmetic 

¢ algorithms (bsearch, qsort, rand, 
and srand) — capturing operations 
complex and widespread enough to 
warrant packaging as library func- 
tions 

* text conversions (atof, atoi, atol, 
strtod, strtol, and strtoul) — 
determining encoded arithmetic 
values from text representations 

¢ multibyte conversions (mblen, 
mbstowcs, mbtowc, wcstombs, and 
wetomb) — mapping between multi- 
byte and wide-character encodings 

¢ storage allocation (calloc, free, 
malloc, and realloc) — managing 
a heap of data objects 

¢ environmental interactions (abort, 
atexit, exit, getenv, and system) 
— interfacing between the program 
and the execution environment 

I discuss separately how to implement 


ended up defined or declared in <stdlib.h>. the functions in each of these groups. This month, I cover only 
This header is not the only hodgepodge. I discuss the evolu- the first two groups. I won’t bother to present the header as a 
tion of the header <stddef.h> in Standard C, CUJ December whole. It’s pretty straightforward. 


1991. 


aa 


P.J. Plauger is senior editor of The C Users Journal. He is secretary of the ANSI C standards committee, X3J11, and convenor 
of the ISO C standards committee, WG14. His latest book is The Standard C Library, published by Prentice-Hall. You can reach 


him care of The C Users Journal or via Internet at pjp@plauger.uunet.uu.net. 
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Now Raima Data Manager 
Formerly db VISTA IIT 


a Re 


Accelerated Database Performance 
Compared to conventional relational databases, retrieval 
of records can be 10—20—even 50 times faster with 
Raima Data Manager from Raima Corporation. — 


Propelling The Biggest Names In Business 
Companies like General Motors, Hewlett-Packard, IBM, 
Eastman Kodak, Rockwell and others are using Raima 
Data Manager in their competitive environments. 
Today's most critical, most demanding applications 
demand the high performance of Raima Data Manager. 


Powerfully Efficient Leading-Edge Technology 
Raima's combined technology merges the flexibility of 
relational databases with the lightning speed and efficient 


Raina Data Manager 
The High Performance DBMS 


[Sneciticatlons!| 


Raima Corporation 3245 146th Place S.E., Bellevue, WA 98007 USA 


™ 


storage of the network model. With the program written 
entirely in C, you can "fine-tune" the Raima Data Manager 
engine for optimum performance in any application. 


Put Yourself In Fast Company 

Give yourself the competitive edge of Raima Data Manager. 
* Speed—faster access to data 

* Portability—supports most environments 

* Royalty-free—increase your profits 

* Source code availility—total programming flexibility 

* Full Raima support services—including training 
Whether you're writing a stand-alone DOS application, 
or one for UNIX accessing thousands of records, Raima 


Data Manager will put your application on the fast track. 


Race to the phone and call for more information! 


In the U.S. or Canada, call: 1-800-DB-RAIMA 


In Washington state or international, call: (206)747-5570 


Relational B-tree indexing. Network data model. Relational SQL query and report writer. Single & multi-user. Automatic recovery. Built-in referential integrity. 
Supports: VMS, QNX, ULTRIX, UNIX System V, Berkeley 4.2, AIX, SunOS, SCO, MS DOS, MS Windows, and OS/2. Most C Compilers and LANs supported. 


(206)747-5570 Fax: (206)747-1991 


International Distributors: Australia: 6124197177 Belgtum: 32 27349818 Finland: 358 080405350 France: 33 | 46092784 Germany: 49 7022 31077; 49 214 9105 * 29 12: 
Japan: 8} 33 865 2140 Mexico; 52 83 49 53 00 The Netherlands: 31 215946814 Norway: 47 238 48 88 Singapore: 65 334 006! Sweden: 46 13.101 588 Switzerland: a sae — 


Taiwan: 886 2 5523277 United Kingdom: 44 992 500919 


Copynght C1992 Raims Corpunition, Au nights resend Phoow Dule LaFollece 
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Listing 1 (abs.c) 


/* abs function */ 
finclude <stdlib.h> 


int (abs) (int 1) 
{ /* compute absolute value of int argument */ 
return ((1 <0) ? -1 3 f)s 
) 


/* End of File */ 


Listing 2 (div.c) 


/* div function */ 
finclude <stdlib.h> 


div _t (div) (int numer, int denom) 
/* compute int quotient and remainder */ 
div_t val; 


val.quot = numer / denom; 

val.rem = numer - denom * val.quot; 

if (val.quot < 0 && 0 < val.rem) 
{ /* fix remainder with wrong sign */ 
val.quot += 1; 
val.rem -= denom; 


return (val); 


/* End of File */ 


pes 


verwrites? 


“~ * 
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Listing 3 (labs.c) 


/* labs function */ 
#finclude <stdlib.h> 


long (labs) (long 4) 
{ /* compute absolute value of long argument */ 
return ((1 <0) ? -i : 4); 
} 


/* End of File */ 


Listing 4 (Idiv.c) 


/* ldiv function */ 
#finclude <stdlib.h> 


Idiv_t (Idiv) (long numer, long denom) 
/* compute long quotient and remainder */ 
Idiv_t val; 


val.quot = numer / denom; 

val.rem = numer - denom * val.quot; 

if (val.quot < 0 && 0 < val.rem) 
{  /* fix remainder with wrong sign */ 
val.quot += 1; 
val.rem -= denom; 


return (val); 


/* End of File */ 


The C Standard on Integer Math 
7.10.6 Integer arithmetic functions 


7.10.6.1 The abs function 
Synopsis 
#include <stdlib.h> 
int abs(int j); 
Description 

The abs function computes the absolute value of an integer 
J. If the result cannot be represented, the behavior is un- 
defined.!°° [FN130. The absolute value of the most negative 
number cannot be represented in two’s complement.] 
Returns 

The abs function returns the absolute value. 


7.10.6.2 The div function 


Synopsis 
#finclude <stdlib.h> 
div_t div(int numer, int denom); 
Description 

The div function computes the quotient and remainder of 
the division of the numerator numer by the denominator 
denom. If the division is inexact, the resulting quotient is the 
integer of lesser magnitude that is the nearest to the algebraic 
quotient. If the result cannot be represented, the behavior is 
undefined; otherwise, quot * denom + rem shall equal numer. 
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BORLAND C++ 


& APPLICATION FRAMEWORKS 


BORLAND C++ 
& APPUCATION FRAMEWORKS 


BORLAND 


THE INDUSTRY-STANDARD C++ WITH 
OBJECTWINDOWS” AND TURBO VISION” 


.. lf you program for a living 


Borland® C++ & Application 
Frameworks 3.0 is the choice of pro- 
fessional C and C++ programmers for 
Windows and DOS application develop- 
ment. With unmatched optimizations, 
powerful tools, unsurpassed Windows 
development environment and object- 
oriented application frameworks, 
Borland C++ & Application Frameworks 
3.0 has no equal. Quite simply, if you 
program for a living, this is everything 
you need. 

OOP, to simplify your life 
Borland C++ & Application Frameworks 
3.0 simplifies programming by giving you 
ready-made user interface objects 
that plug directly into your application. 
Automatically inherit windows, menus, 
scroll bars, mouse support and more. 
Add an editor in just one line. With 
Object-Oriented Programming (OOP), 
you get amazing code reusability, exten- 
sibility and easier maintenance because 
applications are built on a base of tested, 
reliable code. 


The Leader in Olyect-Oriented Programming 


New features give you incredible 
programming options! 

Just look at some of the enhanced features 

in Borland C++ 3.0: 

¢ ANSI C and C++ 2.1 and templates 

Global optimizer includes: 

+ Global register allocation 

+ Local and global common 

sub-expressions 

+ Induction variables 

« Loop and jump optimization 

Register parameter passing 

+ And ten other state-of-the-art 

optimizations 

Increased C++ compile speed 

Windows and DOS Integrated 

Development Environments 

Visual ObjectBrowser™ to view 

class relationships at a glance 

DPMI support for compiler and 

IDE environments gives you huge 

capacity 

EasyWin™ library makes it easy to con- 

vert your DOS programs to Windows 

Resource Workshop for creating 

Windows user interfaces visually 


ORLAN 


© Extensive Microsoft® C compatibility 
© WinSight™ message tracking utility 
* Turbo Debugger” for DOS 
and Windows 
© Turbo Profiler™ for DOS and Windows 
* Object-oriented Turbo Assembler’ 
And with new Borland C++ & Application 
Frameworks 3.0 you get all of this, plus: 
© ObjectWindows™—the application 
framework for Windows 
¢ Turbo Vision"—the application 
framework for DOS 
¢ Source code for runtime library 
and application frameworks 


Optimized for professionals 
Borland C++ 3.0 ($495"*) or Borland 
C++ & Application Frameworks 3.0 
($749™*) are optimized for your life-style. 
But don’t wait. Because when it comes to 
professional programming, there's no 
better way to earn a living than with 
Borland C++. 


See your dealer today 
or call now 
1-800-331-0877, Dept. 5305 


"Suggested retail price. All prices are In U.S. dollars. Dealer prices may vary. Copynght © 1991 Borland Intemational, Ine. All rights resarved, All Bocland products are trademarks of Bertand International, Inc. BI 1451 
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Retums 

The div function returns a structure of type div_t, com- 
prising both the quotient and the remainder. The structure 
shall contain the following members, in either order: 


/* quotient */ 
/* remainder */ 


int quot; 
int rem; 


7.10.63 The labs function 
Synopsis 
#include <stdlib.h> 
long int labs(long int j); 
Description 
The labs function is similar to the abs function, except that 
the argument and the returned value each have type long int. 


7.10.6.4 The Idiv function 
Synopsis 
#finclude <stdlib.h> 
Idiv_t Idiv(long int numer, long int denom); 
Description 

The Idiv function is similar to the div function, except that 
the arguments and the members of the returned structure 
(which has type Idiv_t) all have type long int. 


Using the Integer Arithmetic Functions 


Here is a brief summary of the four arithmetic functions: 

abs — Call abs(x) instead of writing the idiom x < 0 ? 
-x : x. A growing number of Standard C translators generate 
inline code for abs that is smaller and faster than the idiom. In 
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complete automatic code 
generation for the target 


*Background tasking 


eMemory utilization is 
conserved by using TPU's 
for Pascal and many small 
.OBJ files for C. Also 
supports EMS (save to 
disk, Genus version only). 
Complete support for | 
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graphics-MENU Is a 
collection of libraries, 
CASE tools and utilities to 
enable the software 
developer to quickly 
ceate a professional 
Graphical User Interface 
for any application. 
Extensive flexibility allows 
modification to color, size 
and format of most items. 
Library source is available 
to allow total contol. 


both mouse and 
keyboard. 

© Choose native graphics 
variant to work 
standalone with your 
Borland or Micosoft 
compiler, or external 
graphics variant to work 
with MetaWindow or 
Genus GX graphics. 
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Burlington MA 01809 
(617) 273-0421 FAX (617) 270-4437 


DEMO @VGILABLE 


+ Request 143 on Reader Service Card > 


addition, you avoid the occasional 

surprise when you inadvertently 

evaluate twice an expression with side 
effects. Note that on a two’s-comple- 
ment machine, abs can generate an 
overflow, 

div — You call div for one of two 
reasons: 

e div always computes a quotient that 
truncates toward zero, along with the 
corresponding remainder, regardless 
of how the operators / and % behave 
in a given implementation. This can 
be important when one of the 
operands is negative. The expression 
(-3)/2 can yield either -2 or -1, 
while div(-3, 2).quot always yields 
-1. Similarly, (-3)%2 can yield either 
1 or -1, while div(-3, 2).rem al- 
ways yields -1. 

* div computes both the quotient and 
remainder at the same time. That can 
be handy when you need both 
results. It might even be more effi- 
cient if the function expands to inline 
code that contains only a single 
divide. 

Note that the members of the resulting 

structure type div_t can occur in either 

order. Don’t make any assumptions 
about the representation of this struc- 
ture. 
labs — is the long version of abs. 
Idiv — is the long version of div. 


Implementing the Arithmetic 


Functions 


Listing 1 shows the file abs.c. The 
absolute value function abs is the 
simplest of the integer math functions. 
You cannot provide a masking macro, 
however, because you have to access the 
value of the argument twice. Some com- 
puter architectures have special instruc- 
tions for computing the absolute value. 
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“The Best Memory 


It’s an easy claim to 
make, buf we have 
the facts to back it up: 


Our new QEMM-386 version 6 is the 
best way to get the most out of memory. 
It ‘pools’ all your memory so that it’s 
available in whatever form your 


programs aaa 
need— @Glt’s hothing less than a 
expanded dream come =" 
orextend- | —Steve ‘Gibson InfoWorld 8/26/91 
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don’t even need to know the difference. 
QEMM does it all for you. Instantly. 
Whereas DOS 5, for example, requires 
you to figure out what you need, then 
manually allocate memory and re-boot 
every time you need to change. 


As for the all-important ‘conventional’ 
memory area, Our new version 6 increases 
the amount of memory freed-up. Our 
exclusive ‘optimize’ feature automatically 
seeks out TSRs and device drivers and 
moves them into high memory—the area 
between 640K and 1 megabyte. All you 
need do is type ‘OPTIMIZE. 


EMM 
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PC Week rated QEMM 6 the best memory manager. 
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WINDOWS MAGAZINE 
1902 
WIN AWARDS 


Our latest awards. 


QEMM-386 v6 finds more high 
memory than any other memory mana- 
ger. Byte Magazine's tests showed it 
produced net memory gains of 21K to 
132K over DOS 5.0 alone, for instance. 


Stealth takes you to network 


and TSR heaven. 


Our breakthrough ‘Stealth’ technology 
makes available areas normally taken u 
by ROM. Areas that QEMM-386 can use 
to load memory-hogging drivers and 
TSRs. Big programs can get the 
memory they need to run fast and 
efficiently. And you get to have 
your TSRs. 

Not every PC can benefit from 
Stealth. But every PC can benefit from 


‘Squeeze’—our new 
feature to accommodate 
those TSRs that need 
more memory at start 
up and less when 
they're resident. 
Memory allocation is 
temporarily increased, 
then squeezed down 
after it’s needed. 

QEMM can use idle 
video memory to produce a further 96K 
gain on EGA and VGA systems when 
running character-based programs. 


A priceless $60 bonus. 


QEMM comes with ee 
Manifest, the award- 
winning analysis 
program that shows 
what's going on ‘under 
the hood’ of your PC. 

Manifest does for memory what PC 
Tools Deluxe does for disks. 


Big Benefits for 


Windows users, too. 
Whether you're running DOS 3, 4, 5, or 
Windows, QEMM can improve your 
386/486's performance. 

That means you may not need a 
faster CPU. You may not even need 


it 


QEMM is not only 
the best selling 
memory manager, 
it’s the number one 
selling PC utility. 


Hr \ more RAM. QEMM makes your 


favorite programs work better by 
giving them more memory. 

QEMM helps you get the most 
out of the software you own today. 


Quarterdeck Office Systems, 150 Pico Boulevard, Santa Monica, CA 90405 (310) 392-9851 Fax (310) 314-4219 
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That makes obs a prime candidate for special treatment as a 
built-in function generating inline code. 

Listing 2 shows the file div.c. It provides a portable im- 
plementation of the div function. You can eliminate the test if 
you know that negative quotients truncate toward zero. Most 
computer architectures have a divide instruction that develops 
both quoticnt and remainder at the same time. Those that 
develop proper negative quotients are also candidates for 
built-in functions. An implementation is at liberty to reorder 
the members of the structure type div_t to match what the 
hardware generates. 


Returns 

The rand function returns a pseudo-random integer. 
Environmental Limit 

The value of the RAND_MAX macro shall be at least 32767. 


7.10.2.2 The srand function 
Synopsis 
#include <stdlib.h> 
void srand(unsigned int seed); 
Description 
The srand function uses the argument as a seed for a new 


Listing 3 shows the file labs.c and Listing 4 shows the file 
Idiv.c. Both define functions that are simply /ong versions of 
obs and div. 


The C Standard on the Algorithmic Functions 


sequence of pseudo-random numbers to be returned by sub- 
sequent calls to rand. If srand is then called with the same 
seed value, the sequence of pseudo-random numbers shall be 
repeated. If rand is called before any calls to srand have been 
made, the same sequence shall be generated as when srand is 
first called with a seed value of 1. 

The implementation shall behave as if no library function 
calls the srand function. 


7.10.2 Pseudo-random sequence generation functions 


7.10.2.1 The rond function 


Returns 
Synopsis The srand function returns no value. 
finclude <stdlib.h> Example 


int rand(void); 
Description 

The rand function computes a sequence of pseudo-random 
integers in the range 0 to RAND MAX. 

The implementation shall behave as if no library function 


The following functions define a portable implementation 
of rand and srand. 


static unsigned long int next = 1; 
int rand(void) | /* RAND MAX assumed to be 32767 */ 


calls the rand function. { 
next = next * 1103515245 + 12345; 
return (unsigned int) 
next/65536) % 32768; 
} 
REPLACES void srand(unsigned int seed) 
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Synopsis 
#include <stdlib.h> 
void *bsearch(const void *key, 
const void *base, size_t nmemb, 
size_t size, int (*compar 
(const void *, const void *)); 
Description 
The bsearch function searches an 
array of nmemb objects, the initial ele- 
ment of which is pointed to by base, for 
an element that matches the object 
pointed to by key. The size of each ele- 
ment of the array is specified by size. 
The comparison function pointed to 
by compar is called with two arguments 
that point to the key object and to an 
array element, in that order. The func- 
tion shall return an integer less than, 
equal to, or greater than zero if the key 
object is considered, respectively, to be 
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Unleash 32-bit Power! 


WATCOM C9.0/386 lets you exploit the two key 32-bit 
performance benefits. The 32-bit flat memory model 
simplifies memory management and lets applications address 
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speedup. 
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less than, to match, or to be greater than the array element. 
The array shall consist of: all the elements that compare less 
than, all the elements that compare equal to, and all the ele- 
ments that compare greater than the key object, in that 
order.)? {FN129. In practice, the entire array is sorted accord- 
ing to the comparison function.]} 
Returns 

The bsearch function returns a pointer to a matching ele- 
ment of the array, or a null pointer if no match is found. If two 
elements compare as equal, which element is matched is un- 
specified. 


9 whe 


‘Elegant. Reliab! 
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slicing and preemption options 
© Unlimited number of tasks, 

queues, resources, and events 
© Fixed and Variable memory 


Real-time Multi-tasking Executive 


7,10,5.2 The gsoré function 

Synopsis 

#include <stdlib.h> 

void qsort(void *base, size_t nmemb, size_t size, 

int (*compar) (const void *, const void *)); 
Description 

The gsort function sorts an array of nmemb objects, the ini- 
tial element of which is pointed to by base. The size of each 
object is specified by size. 

The contents of the array are sorted into ascending order 
according to a comparison function pointed to by compar, 
which is called with two arguments that point to the objects 
being compared. The function shall return an integer less than, 
equal to, or greater than zero if the first argument is con- 
sidered to be respectively less than, 
equal to, or greater than the second. 

If two elements compare as equal, 
their order in the sorted array is un- 
specified. 

Returns 
The qgsort function returns no value. 


Using the Algorithmic 
Functions 


Here is a brief summary of the four 
algorithmtic functions: 

bsearch — Use this function to 
search any array whose elements are or- 
dered by pairwise comparisons. You 
define the ordering with a comparison 
function that you provide. For example, 
you can build a keyword lookup func- 
tion from the basic form as shown in 

Listing 5. 

A few caveats: 

¢ If a key compares equal to two or 
more elements, bsearch can return a 
pointer to any of these elements. 

* Beware of changes in how elements 
sort when the execution character set 
changes — call qsort, described 
below, with a compatible comparison 
function to ensure that an array is 
properly ordered. 

RTX ¢ Be careful using the functions strcmp 

or strcoll, declared in <string.h>, 

directly. Both require that strings be 


Simple solutions are generally better 
solutions. Complicated solutions often 
reflect poor design. Nucleus embodies 
simplicity. Its elegant style and design 
make it easy to use and understand. 
Nucleusis thebest,most reliable choice 
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CCELERATED TECHNOLOGY ine 


management 
{J Time-out option on all service calls 
© ROMable C source code included 
9 No royalties 
© MS-DOS compatible file system 
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(800) 468-NUKE 


+ Request 203 on Reader Service Card + 


Call now for more information. 


T p.0,80x 850245 Mobile, al 366a5 (205) 450-0707 


stored in the array to be searched. 
You cannot use them to search an 
array of pointers to strings. To use 
strcmp, for example, you must write 
a function pointer argument that 
looks like (int (*)(const void *, 
const void *))&stremp. 
gsort — Use this function to sort 
any array whose elements are ordered 
by pairwise comparisons. You define the 
ordering with a comparison function that 
you provide. The comparison function 
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st 


f 


has a specification similar to that for the function bsearch, 

described above. Note, however, that the bsearch comparison 

function compares a key to an array element. The sort com- 
parison function compares two array elements. 

A few caveats: 

¢ Don’t assume that the function uses the “Quicksort” algo- 
rithm, despite the name. It may not. If two or more ele- 
ments compare equal, qsort can leave these elements in 
any relative order. Hence, qsort is not a stable sort. 

¢ Beware of changes in how elements sort when the execution 
character set changes. 

° Be careful using the functions strcmp or strcoll declared 
in <string.h>, directly. Both require that strings be stored 
in the array to be sorted. You cannot use them to sort an 
array of pointers to strings. To use strcmp, for example, you 
must write a function pointer argument that looks like (int 
(*)(const void *, const void *))&stremp. 
rand — Call rand to obtain the next value in a pseudo-ran- 

dom sequence. You get exactly the same sequence following 
each call to srand with a given argument value. That is often 
desirable behavior, particularly when you are debugging a pro- 
gram. If you want less predictable behavior, call clock or time, 
declared in <time.h> to obtain an argument for srand. The 
behavior of rand can vary among implementations. If you want 
exactly the same pseudo-random sequence at all times, copy 
the version presented here. 

Use RAND_MAX to scale values returned from rand. For ex- 
ample, if you want random numbers of type float distributed 
over the interval (0.0, 1.0], write the expression 
(float) rand() /RAND_MAX. The value of RAND MAX is at least 
32,767. 

srand — See rand above. The program effectively calls 
srand(1) at program startup. 


Implementing the Algorithmic Functions 


Listing 6 shows the file gsort.c. It defines the related func- 
tion qgsort that sorts an array beginning at bose. I introduced 
the type _Cmpfun just to simplify the declaration of arguments 
for the functions bsearch and qsort. Don’t use this declara- 
tion in code that you write if you want it to be portable to 
other implementations. 

This logic is much less simple and more debatable. It is 
based on the Quicksort algorithm first developed by C.A.R. 
Hoare. That requires you to pick a partition element, then 
partially sort the array about this partition. You can then sort 
each of the two partitions by recursive application of the same 
technique. The algorithm can sort quite rapidly. It can also 
sort very slowly. 

How best to choose the pivot element is the debatable 
issue. Pick the first element and an array already in sort eats a 
lot of time. Pick the last element and an array in reverse sort 
eats a lot of time. Work too hard at picking an element and all 
arrays eat a lot of time. I chose simply to pick the last element. 
That favors arrays that need little rearranging. You may have 
reason to choose another approach. 

qsort calls itself to sort the smaller of the two partitions. It 
Joops internally to sort the larger of the two. That minimizes 
demands on dynamic storage. At worst, each recursive call 
must sort an array half as big as the earlier call. To sort N 
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Listing 5 


finctude <stdlib.h> 
finclude <string.h> 


typedef enum {FLOAT, INTEGER} Code; 
typedef struct { 

char *s; 

Code code; 

} Entry; 
Entry symtab(] = { 

{"float®, FLOAT}, 

("integer", INTEGER) } 


static int cmp(const void *ck, const void *ce) 
{ /* compare key to table element */ 
return (stremp((const char *)ck, ((Entry *)ce)->s)); 


Entry “lookup(char *key) 
{ /* lookup key in table */ 
return (bsearch(key, symtab, 
sizeof symtab / sizeof symtab[0], 
sizeof symtab(0], &cmp)); 


} 
/* End of File */ 


elements requires recursion no deeper than log2(N) calls. (You 
can sort 1,000,000 elements with at most 20 recursive calls.) 

Listing 7 shows the file bsearch.c. The function bseorch 
performs a binary search on the sorted array beginning at 
base. The logic is simple but easy to get wrong. 
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/* qsort function */ 
finclude <stdlib.h> 
finclude <string.h> 


/* macros */ 
Idefine HAX_BUF 256 /* chunk to copy on swap */ 
void (qsort)(void *base, size tn, size_t size, Cmpfun *cmp) 
/* sort (char base[size])[n] using quicksort */ 
while (1 <n) 
(  /* worth sorting */ 
size_t 1 = 0; 
sizetjen- 1; 
char *qi = (char *)base; 
char *qj = qi + size * J; 
char *qp © qJi 


while (i < J) 
{ /* partition about pivot */ 
while (1 <j && (*cmp)(qi, qp) <= 0) 
+41, qi += size; 
while (i < j && (*cmp)(qp, qj) <= 0) 
--J, qj -= size; 
if (i < J) 
{ /* swap elements i and j */ 
char buf[MAX_BUF] ; 
char *ql = qi; 
char *q2 = qj; 
size_t m, ms; 


for (ms = size; 0 < ms; 
ms -= m, qi += m, q2 -= m) 
(| /* swap as many as possible */ 
m=ms < sizeof (buf) ? ms : sizeof (buf); 
memcpy(buf, ql, m); 
memcpy(ql, q2, m); 
memcpy(q2, buf, m); 
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Listing 6 (qsort.c) 


/* End of File */ 


++], qi += size; 


) 

if (qi t= qp) 
{  /* swap elements i and pivot */ 
char buf [MAX_BUF] ; 
char *ql = qiz 
char *q2 = qp; 
size_t m, ms; 


for (ms = size; 0 < ms; ms -= m, ql += m, q2 -= m) 
/* swap as many as possible */ 
m=ams < sizeof (buf) ? ms : sizeof (buf); 
memepy(buf, ql, m); 
memcpy(ql, q2, m); 
memcpy(q2, buf, m); 
} 


} 


j2zn-i-1, qi += size; 


if (j < i) 
{ /* recurse on smaller partition */ 
if (1 <j) 
qsort(qi, J, size, cmp); 
neis 
) 
else 
{ /* lower partition is smaller */ 
if (1 < i) 


} 
} 
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THERE’S A WHALE OF A DIFFERENCE BETWEEN QNX® AND UNIX? 


WE’RE GLAD TO OBLIGE. 


Even THOUGH THE QNX REALTIME 
OPERATING SYSTEM IS NOT BASED 

ON UNIX SOURCE CODE, WE CAN 
UNDERSTAND HOW SOME DEVELOPERS 
MIGHT CONFUSE THE TWO. AFTER ALL, 
QNX FOLLOWS THE LATEST IEEE 
POSIX 1003.1 AND 1003.2 OPEN 
SYSTEMS STANDARDS, SO YOU GET 
THE SAME API AND UTILITY SET 


FOUND IN MANY UNIX SYSTEMS. 
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DISTRIBUTED PROCESSING 
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SEAMLESS SUPERCOMPUTER, 
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THE QNX DEVELOPMENT TEAM. 
THEIR EXPERTISE CAN HELP 

YOU KEEP YOUR DEVELOPMENT 


PROJECTS RIGHT ON COURSE. 


TO FIND OUT HOW YOUR 
APPLICATIONS CAN THRIVE IN 
THE QNX ENVIRONMENT, 
CALL 1-800-363-9001, 


(ExT. 102). 


QUANTUM SOFTWARE SYSTEMS LTD. 
17S TERRENCE MATTHEWS CRESCENT 
KANATA, ONTARIO, CANADA 

K2M 1W8 

TEL: 613-591-0931 

FAX: 613-591-3579 


E DIFFERENCE 


QNX (9 4 MEGISTERED TRAQKEMANK OF QUANTUM Sortwant Systema LID. UNIK iS 4 MEGIUTERTO THADEMARE OF UNIX 81 2/1u LABORATORIES, INC. TQUANTUM Sur Te ans QPNTEME Lu oft 


Request 478 on Reader Service Card > 


oe 


See oo, 
nh es 


iy. 


val 4! 


Ba 


Listing 7 (bsearch.c) 


/* bsearch function */ 
#include <stdlib.h> 


void *(bsearch) (const void *key, const void “base, 
size_t nelem, size_t size, Cmpfun *cmp) 
{ /* search sorted table by binary chop */ 
const char *p; 
size_t nj 


for (p = (const char *)base, n= nelems 0 <n; ) 
{ /* check midpoint of whatever is left */ 
const size_t pivot = n> 1; 
const char *const q = p + size * pivot; 
const int val = (*cmp) (key, q)3 


if (val 0) 
n = pivot; /* search below pivot */ 
else if (val == 0) 
return ((void *)q); 
else 
{ /* search above pivot */ 
p=q + size; 
n -= pivot + 13 


/* found */ 


} 
return (NULL); /* no match */ 
} 


/* End of File */ 
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Listing 8 (rand.c) 


/* rand function */ 
finclude <stdlib.h> 


/* the seed */ 
unsigned long _Randseed = 1; 


int (rand) (void) 
{ /* compute pseudo-random value */ 
_Randseed = Randseed * 1103515245 + 12345; 
return ((unsigned int) (_Randseed >> 16) & RAND_MAX); 
} 


/* End of File */ 


Listing 9 (srand.c) 
/* srand function */ #include <stdlib.h> 


void (srand) (unsigned int seed) 
{ /* alter the seed */ 
Randseed = seed; 


/* End of File */ 


Listing 8 shows the file rand.c. The function rand 
generates a pseudo-random sequence using the algorithm sug- 
gested in the C Standard. That has reasonable properties, plus 
the advantage of being widely used. One virtue of a random 
number generator is randomness. Another virtue, ironically, is 
reproducibility. You often need to check that a calculation 
based on pseudo-random numbers does what you expect. The 
arithmetic is performed using unsigned long integers to avoid 
overflows. 

Listing 9 shows the file srand.c. The function srand simply 
sets Randseed, the seed for the pseudo-random sequence 
generated by rand. I provide a masking macro for srand. 
Hence, the header <stdlib.h> declares _Randseed, defined in 
rand.c. 


References 


Donald Knuth, The Art of Computer Programming, Vols. 1-3 
(Reading, Mass.: Addison-Wesley, 1967 and later). Here is a 
rich source of algorithms, complete with analysis and tutorial 
introductions. Volume 1 is Fundamental Algorithms, volume 2 
is Seminumerical Algorithms, and volume 3 is Sorting and Sear- 
ching. Some are in second edition. 

You will find oodles of information on: 

* maintaining a heap 

* computing random numbers 

® searching ordered sequences 

* sorting 

° converting between different numeric bases 

Before you tinker with the code presented here, see what 
Knuth has to say. 0 


This article is excerpted in part from PJ. Plauger, The Stand- 
ard C Library, (Englewood Cliffs, N.J.: Prentice-Hall, 1992). 
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Multiple Copy Math Functions 


Dr. Timothy Prince 


Pipelined architectures including vector and super- 
scalar obtain their speed by depending in part on 
working on independent calculations in pipeline 
fashion. Most computationally intensive applications 
present enough opportunities for parallel or pipeline 
operation to make worthwhile increases in speed. The 
normal use of scalar math functions, which produce a 
Single result, poses an obstacle to superscalar perfor- 
mance. These functions can be organized to increase 
the internal opportunities for parallelism as compared 
with optimum scalar processor code. Performance 
remains far short of the potential, unless more paral- 
lelism is exploited by working on more than one math 
function result at a time. A further reason for obtain- 
ing multiple results is that the overhead for calling 
functions which take less than 10 microseconds be- 
comes excessive. 

Soon after the introduction of vector computers, 
vector math functions were introduced to provide vec- 
tor performance in calculations involving such func- 
tions. With pipelined or superscalar processors, vector 
functions may be effective, but functions which calcu- 
late a small number of copies per call are more ver- 
satile. Since a typical RISC architecture employs a 
four-stage pipeline, functions which calculate two or four 
copies should be enough to maximize performance. 


Vector chunk math functions may be used whether 
or not your compiler makes specific provision for 
them. I will show actual examples of the C code of 
such functions. The functions sin_4 (four sins), 
cosf_sinf_2 (two pairs of float sin and cos), 
powf_2 (two float pows), and tan_2 (two tons) are 
chosen for their proven usefulness and because they 
illustrate the points which I want to make. 


Vector vs Superscalar Function Calls 


On a vector architecture, vector math functions 
naturally are performed on argument vectors, and nor- 
mal vector performance is not approached except on 
long vectors. These architectures perform well when 50 
or more functions are to be calculated at a time. Sup- 
pose we wanted to integrate a function involving sin 
and cos by Simpson’s rule, producing a loop such as 


for(i=2 3; i<xn 3; i += 2){ 
yint += q[{i-2]*sin(t[i-2]) 
+4*q[i-1]*sin(t(i-1])+q[i]*sin(t[i]); 
xint += q[i-2]*cos(t[i-2]) 
+4*q[i-1]*cos(t[i-1])+q[i]*cos(t[iJ); 


Timothy Prince has a B.A. in physics from Harvard and a Ph.D. in mechanical engineering from the University of 
Cincinnati. He has 25 years of experience in aerodynamic design and computation. He can be contacted at 452 Pal- 


mitas St., Solana Beach, CA 92075. 
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*¢ be program to calculate Chebyshef economized polynomial 


e* for evaluation of sin(x) */ 
/* use be =1 to get c() and s{) functions */ 
define t(x) { 


define b(x) [ 
if (x <0) return (-x); 
return (x); } 
define m(x, y) { 
4f (x > y) return (x); 
return (y); } 
n= 22; /* number of Chebyshef terms */ 
scale = 40; 
pea(l.) * 4 /* pf */ 


bep* .5; /* upper end of curve fit interval */ 


ae <b; /* lower end of interval */ 

/* chebft adapted from Press Flannery et al */ 
/* "Numerical Recipes® FORTRAN version */ 

for (k © 1; k <=e ng tek) { 

c[k} = 0; 


f[k} = t(e((k - .5) * p/n) * (b- a) * 5 ¢ (b+ a) * .5)3 


/* because of symmetry, even c[] are 0 */ 
for (J = 15 J <e nj J t= 2) 

s 205 

q*(¥-)1) * p/n; 


for (k = 1; k <= ny t#k) s t= c(q * (k = .5)) * f[k]; 


(c(j) = 2/n*s); } 


which involves n evaluations of sin and cos. A vector compiler 
would start out by setting up the six vectors made up of the 
three sin and cos evaluations from each copy of the loop 
body. Almost a third of these evaluations would be duplicates, 
since the vector of sin(t[i-2]) is the same as the vector of 


7* sin(x)/x */ 
if(x="O)return(1.)3 /* derfvative of s function */ 
return (s(x) / x): /* put function to be fit here */ } 


Listing 1 (s) 


/* skip even terms, which are 0 */ 


/* chebpe */ 


for (n = 5; n <= 19; n #* 2) { 


for (J = 1; J <= ny ++J) d[J] = e[§] = 0; 


4[1) = c[n); 


s = d{k]s 


for (J = n= 25 J >= 23 -J) { 
for (k= n= J + 15 k >= 2; -k) { 


d({k] © d{k - 1) * 2 - efk); 


e[k] = 33] 


s° d(1); 


{1} = tH - ef); 


e(1} = s3 


for (j= nj; j u 23 -J) d(3) © d{j - 1) - ef5]; 
d(1)] = c[1] * .5 - ei); 


/* peshft */ 
g*2/ (b- a); 


for (J = 23 Jj <= nj ++§) { 


a{j] *= 95 


g**2/ (b- a); ) 
for (j= 13 J < ng t+) ( 


h= d(n]; 


for (k= n- 1; k >= Jy -k) { 


he dk) - (a+b) *.5*h; 


a[k] = hs ) 


"Chebyshev Sin fit |x|<P1/2 coeffictents® 
" Maximum Rel Error:" 


m(b(c[n + 2]), b(c[2})) / t(b); 


for (1 = 1; 1 <9 ng 1 += 2) df); 


} 
/* End of File */ 
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sin(t[i]) except that sin(t[0]) and sin(t[n-1]) are not 
repeated. Each of these vectors has length (1 +1)/2, som would 
have to be around 100 before good vector performance could 


In order to approach the performance potential of a vector 


architecture, we would have to rewrite 
the code to store the g[]*sin() and 
q[]*cos() intermediate results in vec- 
tors in a preliminary loop, and then add 
the appropriate values in another loop. 
Even after 20 years of vector compiler 
development, this is more analysis than 
any compiler can do without human as- 
sistance. Most reasonable attempts to 
improve the performance of this loop 
for a scalar architecture will prevent 
vectorization, and changes to improve 
vector performance will reduce scalar or 
superscalar performance. Although vec- 
tor compilers now deal well with sum 
reductions such as this loop, this is done 
in effect by splitting the vectors again 
into six to 10 shorter vectors, making a 
vector architecture less than fully effec- 
tive for this type of application. 
Unrolling compilers can eliminate 
most of the duplicate operations by 
combining the common subexpressions 
over several iterations of the loop. Each 
additional loop iteration will require an 
additional pair of sins and coss. Com- 
pilers have been available (e.g. Multi- 
flow) which would detect this situation 
automatically and build in a call such as 
cosf_sinf_2(t[0],t[1]) which returns 
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cosf and sinf of both arguments, a total of four results from 
one function call. Such a function is a good match to the ar- 
chitecture of a superscalar processor. Even if your compiler 
does not perform the transformation automatically, manual 
rewriting is not unduly burdensome and need not detract from 
performance on scalar processors. A change as simple as 


ty = q{0]*sinf(t[0]); 

tx = q(0]*cosf(t[0]); 

for( i523; i<n; it=2){ 
temp = cosf_sinf_2(t[i-1),t[i]); 
yint ty+q[i] *temp.sin2+4*q[i-1]*temp.sinl; 
xint += tx+tq[i]*temp.cos2+4*q[i-1]*temp.cosl; 
tx = q{i]*temp.cos2; 
ty = qg[i]*temp.sin2; 


+ 
r) 


} 


should produce most of the advertised performance of any 
non-vector machine. 


Vector and Vector Chunk Function Coding Style 


Multiple copy or vector chunk math functions, like vector 
code, need to be written without conditionals which actually 
cause transfer of control. In a scalar trig function, it would 
usually be worth while to test the argument to find out 
whether it needs to be translated into the primary range. In a 
vector chunk function, the full range reduction should be per- 
formed whether it is needed or not, so that all of the code for 
the function can be compiled as one basic block. 

Transfer of control (branching) gives 
the compiler a choice of undesirable 
consequences. Either the pipelines must 
be allowed to empty, reducing the per- 
formance to scalar levels until they are 
refilled, or trace scheduling must be used 
to fill the pipeline with future opera- 
tions along the preferred path of execu- 
tion. Each branch can cause generation 
of another trace, and the length of com- 
piled code may grow exponentially with 
the number of branches. The speed 
gained by keeping the pipelines full may 
be canceled by increased paging. 

A great deal of progress has been 


in vectorizable form, even when the overall scheme is to favor 
superscalar execution, 

Vector chunk functions do not fit well with the <errno. h> 
system for error reporting. The best that can be done is to 
report that ERANGE or EDOM exceptions have been raised for 
one of the arguments or results. Vector functions give an even 
hazier indication of trouble. 


Some Nuts and Bolts of Machine Dependence 


In some of the examples, the sign of a float or double is 
tested by assuming that it is in the same position as the sign of 
an int which shares the same storage. This is done either be- 
cause it is faster or because it reduces register thrashing on 
certain machines. Generally, in these functions, there is an im- 
balance of double over integer arithmetic, and integer opera- 
tions can be treated as a free resource whenever float opera- 
tions are being performed at the same time. 

This code will work as is on most modern architectures 
which use the same byte order for double and int. On VAX- 
compatible architectures, the sign of a double falls in place 
with the sign of a short at the same address, apparently as a 
result of the PDP-11 ancestry. 

A few architectures also suffer from excess of divide and 
multiply operations over add and subtract, so, in the examples, 
addition is used instead of multiply by 2. In these examples, it 
occurs when there are plenty of pipeline slots open, but in 
other cases, one would not want to prevent an optimizing com- 
piler from converting multiply by 2 to a ldexp operation. 


tO 
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made in architecture and compilers in 
recent years, so that many simple condi- 
tional selections can be performed 
without a transfer of control, if this is 
necessary to keep a processor producing 
results at rated speed. This requires cal- 
culation of both alternative results fol- 
lowed by instructions which select the 
correct one. There is a good correspon- 
dence with the syntax of ?: in C, al- 
though the compiler should not be to- 
tally dependent on the programmer 
choosing to use ?. Existing compilers do 
not vectorize if..else. All of the 
operations in the sin, cos, tan, exp, and 
log functions can and should be written 
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As the conditionals which would be required for architec- 
tures not conforming to IEEE P754 standards would clutter up 
the code, I have simply put in #error preprocessor directives, 
which are ignored by non-ANSI compilers because they are 
indented. 

Since a good pipelining compiler will give priority to finish- 
ing up the expressions which are placed first in the code, the 


later copies of the functions tend to fall behind. This may be 
aggravated by compilers which give priority to loading con- 
stants into registers long before they can be used. The way to 
compensate is to write the earlier copies so as to minimize use 
of registers and leave more empty pipeline slots which can be 
filled up by arithmetic from the later copies. 


Listing 2 (sin_4.c) 


typedef struct { 

double X1, X2, X3, X4; 
} ARG_D 4; 
finclude "float.h® 
ARG_D_4 sin _4(xxl, xx2, xx3, xx4) 

double xxl, xx2, xx3, xx4; 
/* use where cos of same argument not needed 
** 16 digits precision, compare to 15 digits in “dtrig.h" 
** TC Prince */ 


/* vector 4 */ 


union dblfmt [{ 
double dbl; 
int idbl; 
struct dfmt { 
unsigned int sign:]; 
unsigned int ex:11; 
} fmt; 
} xils 
double xr, x2, x4, x8; 
fifdef — STDC 
long double pi = 3.1415926535897932385, pml; 
finclude <limits.h> 
felse 
register double pi = 3.1415926535897932385, pml; 
#define LONG_MIN 0x80000000 
fendif 
union dblfmt pm, round; 
ARG_D 4 res; 
fdefine BIAS DBL_MAX_EXP 
finclude <errno.h> 
#ifndef errno 
extern int errno; 
fendif 
#define ODD(i) ((i)&1) 
/* use identity sin(x + n pi) = (-1)*n sin(x) 
** to reduce range to -pi/2 < x < pi/2 
=a pml=rint(xil/pi) */ 
#if FLT_ROUNDS != 1 
ferror "rounding mode not nearest; adjust code” 
fendif 
fif FLT_RADIX !=2 && FLT_RADIX != 10 
ferror "code not optimum for accuracy in this RADIX" 
fendif 
#if DBL_OIG > 16 
ferror "more terms needed for full accuracy" 
fendif 
/* shortcut test’ of sign, not portable to VAX */ 
round.db} = 1 / LDBL_EPSILON; 
xil.dbl = xxl; 
round.idb] j= xil.idb] & LONG MIN; 
pml = xxl / pi + round.dbl; 
/* sign reversal may reduce register usage */ 
xr = pi * (pml -= round.dbl) - xxl; 
/* shortcut test for fabs(pml) > INT MAX */ 
pm.dbl = pml; = 
if (pm. fmt.ex > BIAS + 31) 
errno = ERANGE; 
/* don't wait to calculate xr**2 until sign is fixed; 
** another sign reversal is due if pm.dbl is odd */ 
x2 =e xr * xr} 
/* first sign reversal compensated in coefficient signs; 
** conditional sign fixed by testing odd/even 
** first two results are obtained by straight Horner 
** polynomial evaluation */ 


/* TEEE p754 */ 
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res.X1 = (-.9999999999999999 + x2 * (.1666666666666607 
+ x2 * (-.83333333332828le-2 + x2 * (.19841269824875e-3 
+ x2 * (-.2755731661057e-5 + x2 * (.25051882036e-7 
+ x2 * (-,160481709e-9 + x2 * .7374418e-12))))))) 
* (ODD((int) pm.dbl) ? -xr : xr); 
/* sin(xi2) */ 
round.db] = 1 / LDBL_EPSILON; 
xil.dbl = xx2; 
round.idb] |= xil.idbl & LONG_MIN; 
pm) = xx2 / pi + round.dbl; 
xr = pi * (pml -= round.dbl) - xx2; 
pm.db? = pml; 
if (pm.fmt.ex > BIAS + 31) 
errno = ERANGEs 
x2 = xr * xr; 
res.X2 2 (~.9999999999999999 + x2 * (.1666666666666607 
+ x2 * (-.83333333332828le-2 + x2 * (.19841269824875e-3 
+ x2 * (-.2755731661057e-5 + x2 * (.25051882036e-7 
+ x2 * (-.160481709e-9 + x2 * .7374418e-12))))))) 
* (ODD((int) pm.dbl) ? -xr : xr); 
/* sin(xi3) */ 
round.db] = 1 / LDBL_EPSILON; 
xil.db] = xx3; 
round.idb] |= xil.idb? & LONG MIN; 
pm] = xx3 / pi + round.dbl; 
xr = pi * (pml -= round.db1l) - xx3; 
pm.db] = pml; 
if (pm.fmt.ex > BIAS + 31) 
errno = ERANGE; 
x2 = Xr * xr3 
x4 = x2 * x23 
/* split into 2 Horner polynomials to increase 
** parallelism after Ist result finishes */ 
res.X3 = (-.9999999999999999 + x2 * (.1666666666666607 
+ x2 * (-,833333333328281e-2 
+ x2 * .19841269824875e-3) ) 
+ (-.2755731661057e-5 + x2 * (.25051882036e-7 
+ x2 * (-,160481709e-9 
+ x2 * .7374418e-12))) * x4 * x4) * 
(ODD((int) pm.db1) ? -xr : xr); 
/* sin(xi4) */ 
round.dbl = 1 / LDBL_EPSILON; 
xil.db] = xx4; 
round.idb] |= xil.idbl & LONG MIN; 
pml = xx4 / pi + round.dbl; 
xr = pi * (pm) -= round.dbt) - xil.dbl; 
/* errno is set to ERANGE if any of the arguments are too 
** large for reasonable range reduction */ 
pm.db? = pml; 
if (pm.fmt.ex > BIAS + 31) 
errno = ERANGE; 


x2 = xr * xr; 
x4 = x2 * x2; 
xB = x4 * x4; 


/* multiply by 1 is K&R way to enforce parentheses */ 
res.X4 = ((-.9999999999999999 + x2 * (.1666666666666607 
+ x2 * (-.833333333328281le-2 
+ x2 * ,19841269824875e-3))) * 1 
+ (-.2755731661057e-5 + x2 * (.25051882036e-7 
+ x2 * (-.160481709e-9 + x2 * .7374418e-12))) * x8) 
* (ODD((int) pm.db1) ? -xr : xr); 
return res; 


/* End of File */ 
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The later copies are written for more available parallelism 
at the expense of register usage, so that, when the calculation 
of the earlier results has finished, the pipelines can still be 
kept full nearly to the end of the function. This can lead to 
somewhat greater round off errors in the later copies, in the 
double functions, In the float functions, use of double arith- 
metic eliminates the effect of order of operations on accuracy. 

Systems which are unable to perform simple conditional 
selections without branching may require sign changes to be 
performed by xoring the sign bit. To avoid branching, errno 
may be left alone or set by 


errno=ERANGE&(-(relational expresssion) ) 


which sets it to zero or to ERANGE. This is contrary to the nor- 
mal requirement that errno never be set to zero, but may be a 
satisfactory compromise. 


Calculation of Coefficients 


Listing 1 shows a be program for calculation of coefficients 
for sin, as used in sin_4.c. Running it with double arithmetic 
in C will produce the same results up through at least 10 
digits. Because bc uses fixed point arithmetic, it needs extra 
fractional digits for sin, more than are needed for most 
problems. The same program will work if the t function is 
replaced by a(x)/x, with appropriate changes in the interval. 
The coefficients for log base 2, used in powf_2.c, are calcu- 
lated by having the ¢ function evaluate the appropriate Taylor- 
Maclaurin series. With overnight runs, bc can calculate coeffi- 
cients up to 50 significant digits. These 
Chebyshef subroutines are adaptations 
of those given by Press, Flannery et al 


(1). 
Multiple Copy sin 


Listing 2 shows the four copy sin 
function. The code which performs 
range reduction, by subtracting off the 
nearest multiple of pi, uses a rint func- 
tion, but takes advantage of the fact that 
dividing by pi does not change the sign. 
It assumes that addition is performed in 
the highest available precision, which 
may be more than double. rint is not 


Portability at the expense of speed can be obtained using ex- 
pressions such as 


pm = (fnt) (x/pi+(x>0?.5:-.5)) 
or 
pm = (int) (x/pi-.5+(x>0)) 


since, if fabs(x/pi) exceeds INT MAX, there probably aren't 
more than three digits significance left. Since FORTRAN and 
Pascal have round double to integer syntax, certain processors 
(e.g. MIPS) have implemented it as a single instruction, which 
is not used by C compilers. 

The integer overflow situation is reported as errno=ERANGE, 
without distinguishing which of the four arguments caused it. 
Non-portable code for testing the exponent field to identify 
this situation is used because, on the system where the code 
was tested, there weren’t enough double registers to squeeze 
in any more standard arithmetic without stretching the code 
out by 30%. There are ways to test whether pm is odd without 
ever casting to int, so that range errors are avoided out to 
pi/DBL_EPSILON, but it’s not worth the trouble. 

Covering the whole interval from -pi/2 to pi/2 with a 
single curve fit avoids conditional branches which are par- 
ticularly troublesome for vector or vector chunk coding. An 
eight term Chebyshef-economized polynomial is just sufficient 
to hold the errors to 1 unit-in-the-last-place with 
DBL_MANT_DIG = 53, in the absence of other approximations. 
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covered by standards, and its result may 
depend on rounding mode, so it would 
not take care of portability. Use of Long 
double precision in these operations is 
highly desirable, but of little value un- 
less a true long double value of pi is 
available. long double should prevent 
degradation of accuracy for arguments 
up to pi*10*(LDBL_DIG-DBL_DIG). 

The sign of the argument is ored 
into the rounding constant in order not 
to tie up as many double registers, so 
that the operations on subsequent 
copies will not be delayed. This proce- 
dure avoids branching on processors 
which do not have a select operation. 
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Listing 3 (sin_4 ~ bt.c) 


/* Tests sin_4() */ 

typedef struct { 
double X1, X2, X3, X43 

} ARG_D_4; /* vector 4 */ 

ARG_D_4 sin_4(); 

finclude <math.h> 

main) { 

ARG_D 4 res; 
resesin 4(-2.,-legler2s)§ 
printf ( 

"\th. 17g\t%. 17g\n\ th. 17g\th. 17g\n\th. 17g\ th. 17g\n\ ts. 17g\t%.17g\n", 
res.Xl,sin(-2.), 
res.X2,sin(-1.), 
res.X3,sin(1.), 
res.X4,sin(2.))3 


) 
/* End of File */ 
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Putting the interval end points where 
the function has zero slope helps 
prevent round off error from introduc- 
ing discontinuities. 

Horner polynomial evaluations are 
begun before the sign of the result has 
been determined, leaving the sign 
switching to be performed when the 
compiler finds the necessary pipeline 
slots. The third and fourth polynomial 
evaluations will lag well behind the first 
and second, so the third and fourth 
Horner polynomials are split in two so 
that the pipelines can be kept fuller 
after the earlier polynomial evaluations 
are complete. This adds two multiplica- 
tions and one possibly significant round 
off error in each of the third and fourth 
results. 

The fourth copy differs from the 
third only in that the code is written 
with parentheses to force the final addi- 
tions to occur in the most parallel (but 
not most accurate) order. The dummy 
multiply by 1 is needed to force K&R 
compilers to honor the parentheses, but 
has no effect in ANSI syntax. Since 
similar techniques are used to a greater 
extent in scalar math libraries for super- 
scalar processors, these less accurate 
results are likely to be closer to the 
scalar results. 

This function should achieve a 
megaflop rating better than the LIN- 
PACK rating on many processors, which 
is unusual effectiveness for such com- 
plex code. One of the ways it could be 
used would be to combine calculation of 
unrelated sins and coss, using the 
relationship 


#define cos(x) sin(PI/2-(x)) 


as needed. A similar tactic should pay 
off on vector architectures, in which the 
various arguments are copied to a tem- 
porary vector so that the vector sin 
function can be used. 

Effective pipelining of this function 
appears to require more than 16 double 
registers, along with special efforts to 
perform as many calculations as pos- 
sible in int registers. Examination of 
results of an early MIPS compiler 
showed that it was able to economize on 
the size of generated code by setting the 
constants only once. Like many RISC 
architectures, MIPS has immediate con- 
stants available only to initialize 
registers, not to participate directly in 


floating point operations. This may not 
leave enough registers available for ex- 
tensive pipelining. 

Optimization for reduction of length 
of generated code prior to scheduling of 
operations is less well correlated with 
execution speed on pipelined than on 
scalar processors. The MIPS software 
does not report the number of empty 
pipeline stages. The compiler for the 
original Multiflow 7/200 compiles this 
code in 96 major instruction cycles and 
obtains a superscalar speedup factor of 
4. Only six of these instructions are 
empty, all occurring after the first copy 
result is complete. sin_4 on the Multi- 
flow is twice as fast as their library sin, 
giving four results in 12 microseconds. 
On the Silicon Graphics 4D/25, both 
sin_4 and the library sin take about 
four microseconds per result. 

Listing 3 shows a test driver to com- 
pare the results of sin_4 with sin. 
While many compilers allow passing a 
double to a function which receives it as 
a union, other compilers push a union 
on the stack in a different order from a 
plain double. It is safer to make sin_4 
copy the arguments into its unions. On 
one of the compilers tested, the 
generated code is the same either way. 

The Chebyshef fit of Listing 1 can be 
changed to use sin _4, after changing 
from bc to C syntax. The order of 
Chebyshef fit may as well be a multiple 
of 4. The accuracy of math function ap- 
proximations, such as the functions dis- 
cussed in this article, can be tested by 
fitting Chebyshef polynomials and com- 
paring the coefficients with those ob- 
tained by a higher accuracy calculation 
in the same interval. 


Multiple Copy Float cos 
and sin 


Listing 4 shows a function to calcu- 
late cos and sin of two arguments in 
float precision. Since it uses rational 
polynomial approximations, there is 
more built-in opportunity for paral- 
lelism than in a Horner polynomial, and 
two such functions are enough to fill a 
four stage pipeline at the peak stages. 
Without prototypes, the only way to 
pass float arguments without widening 
to double is by unions. With prototyp- 
ing, it would be better to pass float ar- 
guments and copy them to unions inside 
the function. 
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One multiply can be eliminated from 
the critical path by scaling the argu- 
ments to multiples of pi/2 and adjust- 
ing the polynomial coefficients accord- 
ingly. The division by 2 of the half-angle 
formulae is buried in the coefficients, so 
the range reduction maps the arguments 
into the range -2 to +2, Adding and 
subtracting 4/LDBL_EPSILON produces a 
number which is rounded to the nearest 
multiple of 4. As long as promotion to 
IEEE double is used, so that no precau- 
tions against underflow are needed, 
there would be no problem in changing 
the scaling so that the code could start 
off 


tn = xl.f1t/2/PI - rint(xl.flt/2/P1) 


in case that could be calculated more ef- 
ficiently. The choice of scale was in- 
fluenced by the desire to maintain ac- 
curacy if base 16 arithmetic is used. 
Scaling the arguments would 
produce an additional round off error if 
the calculations were performed in 
float precision, but double is almost 
mandatory anyway as it prevents 
degradation of accuracy for arguments 


up to 2pl*10*(DBL_DIG-FLT_DIG). A 
warning such as storing a value into 
errno could be provided when larger ar- 
guments arrive, but this is not clearly a 
failure meriting the ERANGE label unless 
the argument becomes so large that the 
rint code won’t work. Basing the errno 
calculation on values which are calcu- 
lated anyway minimizes the use of addi- 
tional registers. 

The first rational polynomial is cal- 
culated Horner style, and the fast at- 
tempts to catch up by calculating all 
terms individually, at the cost of one ad- 
ditional multiplication. The scheme of 
eliminating one of the coefficients by 
choice of scale allows the numerator to 
get a head start so that the final multi- 
plication can be performed without 
delaying the division. The compiler may 
have to be forced into performing the 
first add in the denominator without 
waiting until the last term has been cal- 
culated. Certain compilers insist on con- 
verting the repeated divisions into mul- 
tiplications, which is no problem when 
the operations have been promoted in 
precision. 
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Vector Chunk float pow 


The pow function in C is expected to embody two entirely 
ditferent types of operation. In order for it to be vectorizable, 
or to obtain good vector chunk performance enhancement 
with current compilers, it has to be restricted to the cases of 
positive base, where it can be replaced in effect by 


fdefine pow(x,y) exp(log{x)*y) 


This could be done with a top level powf_2 which determines 
whether both pairs of arguments are of one type, and, if so, 
invokes an appropriate vector chunk function. The usual test is 
whether yJ and y2 are changed by casting to int and back to 
float. It doesn’t hurt much to use the log treatment anyway, 
unless x is negative. If the argument pairs cannot be processed 
by the same algorithm, it would have been more efficient not 
to have tried to treat them as a vector chunk at all. 

The function of Listing 4 does not take care of the negative 
base case, which is OK according to ANSI standards if it is 
called as the implementation of the FORTRAN real exponen- 
tiation operator. I use it in this form in time marching 
aerodynamics codes, where it gets executed millions of times. 

Promotion to double is really needed only in the sections 
involving addition of the integer exponent to the base range 
log2 up to the splitting of the exp2 argument into an integer 
plus or minus a fraction, and then only when the result is far 
from 1. The somewhat complicated system for splitting the 
base into modified frexp form works quickly and accurately 
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Listing 4 (powf_2.c) 


typedef atruct ( 
float Xi, X2z 
} ARG_F_2; 
Sinclude "float. h® 
finclude <errno.h> 
difndef errno 
extern int errno; 
fendif 
ddefine MANTAITS (FLT_MANT DIG 1) 
ARG_F_2 powf_2(x(l, yl, x12. y2) 
unfon fltfmt { 
float fit; 
int iflt; 
struct ffat { 
unsigned int ext9; 
unsigned int mant:MANTAITS; 
| fat; 
] x41, x42, yl, y2s 


/* vector 2 */ 


/* VAX: must change all this */ 


{ 
Odafine max(t,J) ((1)>(9)701):(4)) 
define min(t.5) ((1)¢(5) 704): (4)) 
#1f FLT_MANT DIG I= 24 
ferror “use portable frexp() Idexp() */ 
fendif 
#if FLT_ROUNDS == 1 
dif defined(_ sto¢_) 
/* This works on some non-ANS] compflers */ 
Adefine ROUND(x) ((x)>*07( \ 
(x)¢1/LOBL_£PS1L0N)-1/LDBL_EPSILON: \ 
((x)-1/LOBL_EPSTLON) +1/LOBL_EPSIELON) 
felse 
Adefine ROUNO(x) ((x)>*07{ \ 
(x)41/LOBL_EPSILON)*1-1/LDBL_EPSILON: \ 
((x)=1/LD8L_EPSTLON)*141/LDBL_EPSILON) 
dendif 
felse 
Adefine ROUND(x) ({x)><O7 (int) (xo.5): (tnt) (x-.5)) 
dendif 
int mi, mi2, mstgn; 
double xr, x2, r. rl; 
ARG_F_2 res; 
/* Capy 1 */ 
/* This frexp() operation would be done better after 
** promotion to double 
** but {t's not mandatory unless dealing with gradual 
«* underflow; 
** {t would eliminate most cases of O and Inf changing 
** to finite numbers 
oe 4f((xil. fl t=frexp(xil. fit, bat) <sqrt(.5)){ 
omy 
xiliflt = 2; 
ST 


mf = ((xiL.iflt & OxIfEffttt) - 
(mi2 = (wil. fmt.mant < 02350413 7 
(2 - FLT_MIN_EXP) << MANTBITS : 
(1 = FLTCMINEXP) << MANTBITS))) 
>> MANTBITS; 
{f (xf. Aft <0 | xf2.1f1t <0) errno = EDOM; 
m{L.dflt = mi2 | xil.fet.mant; 

/* Mult by y distributed to {ncrease parallelism */ 
rlo= (xr = (xflefit - 1) / (xtlefit ¢ 1)) * yl.tits 
wer * ory 

/* Coeffictents determined by Chebyshef fitting 

** double precisfon {s only really needed from here */ 
r= yl.flt * (double) ai + rl * (2.8853904 + 

x2 * (5958 * 12 + .961588)); 

/* Mstgn = (r -= rint(r)) < °/ 
msign = (r -= rl = ROUNO(r)) < 0; 

r *= 325.0718418 + (x2 =r * r); 
x2 © 360.8810526 + 17.3342336 © x2; 

J* XA A1t © Idexp((x2er)/(x2-r),(int)r1) */ 
xUL lt = (x2 ¢ r) / (02 - ry 

/* Preferably do this Idexp() operation in double, 

e but {t's slower, 

** even though msign can be eliminated; 

e* {t would always give Inf rather than NaN 

** and would allow use of gradual underflow */ 
xGlifit ¢© (max(FLT_MIN EXP - 2 + msign, 

min(FLT_WAX_EXP + msign, (int) ri)) << MANTBITS); 
/* X.fet.exns-mi; with limiting to prevent exponent wraparound °/ 
wes. Xl = xfl. fits 

/* Copy 2 */ 
al = ((xi2.iflt & ox7tfetret) - 

(al2 © (x12. fet.mant < 0x3504f3 7 
(2 - FLT_MIN_EXP) << MANTBITS = 
(1 ~ FLY HIN_EXP) << MANTBITS))) 
>> KANTBITS; 
mi2.4f1t © af2 | x12. fot.mant; 
ple (xr = (xf2.flt - 1) / (xf2.fit + 1)) * y2.ot; 
vl ** x2 = xr * xr 
r= y2.flt * ((double) af + xr * 2.6853904) + 
rk * (.5958 * x2 + .961588); 
miign = (r -= rl = ROUND(r)) < 0; 
r *=s 125,0716418 + (x2 =r * r); 
x2 = 360.8810526 + 17,3342336 * x2; 
ub2.flt = (x2 ¢ r) / (x2 - r)s 
ui2.1f1t = (wax{FLT_MIN EXP - 2 + asign, 
min(FLT_MAX EXP + asfgn, ({nt) rl)) << MANTBITS); 
res.X2 = x{2.flt; 
return res; 


) 
/* End of File */ 
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without widening on a system without gradual underflow. On 
architectures such as VAX which use a different byte order for 
float and int, the unions and constants are different. 

If gradual underflow is to be supported without widening 
the precision, it will require special case treatment. To reduce 
degradation of accuracy if widening is not used for addition of 
the integer and fraction parts of the log2 function, log2 
should be split into a power of 2 plus a smaller term. This 
leads to complicated code which may require branching, thus 
defeating attempts to gain pipelined performance. 

Evaluation of log2(x2)*y2 is speeded up by grouping 
the terms in pairs. The calculation log2(x2)*yl then 
becomes a bottleneck until the multiplication by yJ is dis- 
tributed onto the two groups, one of which consists of the 
three-term Horner polynomial. Multiplication of yl by the in- 
teger exponent is performed well before it is needed. 

Making such detailed adjustments for a given system is pos- 
sible only with readable assembly language which displays the 
final scheduling of the pipelined operations, and is helped 
greatly by static profiling which gives the effective clock count 
for each block of generated code. Since we try to write these 
functions so that there is only one code block, and there are 
few memory accesses which could introduce bus delays, the 
speed will not depend on data and there should be no ques- 
tion what effect each change has on speed. 

In order to make the ROUND macro work the same under 
K&R syntax as it would in ANSI C, dummy multiplications by 
1 are introduced. Otherwise it is a matter of luck whether a 
K&R compiler will generate the re- 
quired code, although the left as- 
sociativity of the + and - operators 
should produce a preference for left to 
right evaluation. From an algebraic 
point of view, ROUND would do nothing, 
and AI techniques could conceivably 
allow a compiler to know this. The 
peculiar syntax of K&R which requires 
such multiplications by 1 makes it semi- 
obligatory for optimizing compilers to 
eliminate the redundant operation, un- 
less compiling for an architecture which 
may generate faster code with alternat- 
ing multiplication and addition. 

If the compiler is unable to generate 
efficient code for the max and min 
macros, it would be better to perform 
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the ldexp operations on doubles and 
hope that the extra range of double will 
take care of over and underflows. 


Multiple Copy tan 


The tan_2 function (Listing 5) re- 
quires the least non-portable coding for 
optimum results, but it illustrates op- 
timizations which have not appeared in 
the functions discussed above. 

Range reduction consists simply of 
subtracting the nearest multiple of pi, 
and there is no advantage in playing 
games with unions. The comparisons 
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Listing 5 (cosf_~ bs.c) 


typedef struct { 
float cosl, sinl, cos2, sin2; 
} ARG_FF_2; /* vector 2 pairs */ 
ARG_FF_2 cosf_sinf_2(x1, x2) 
union { 
float fit; 
int iflt; 
x1, x25 
{ /* 2 pair single precision 
sin/eos function */ 
finclude "float.h" 
@if FLT_ROUNDS t= 1 
ferror “rounding mode not nearest, fix code" 
fendif 
finclude <errno.h> 
fifndef errno 
extern int errno; 
fendif 
le @include <math.h> 
fdefine 0.63661977236758134308 
tdefine 2*H_2_ PI 
fdefine T2Pr*T2P1 
fdefine TP2*T2PI 
édefine TP2*TP2 
édefine TP3*TP2 
ARG 
double tn, td, rs 
/* integer compare with 0 same as float, for IEEE 
** since arg comes in int register, this is faster 
ee 
** doing everything in double, we won't lose accuracy 
** by converting arg to multiple of PI/2 
** this allows range reduction by subtracting an integer 
Ci 
** reduce to range +- 2, divide by 2 later 
** when it cannot underflow */ 
tne xl.flt * M2 PI + (td = xl.iflt >= 0? 
4 / LOBL_EPSILON : -4 / LOBL_EPSILON); 
if (fabs(xl.flt * M_2 PI) >= 4 / LDBL_EPSILON | 
fabs(x2.flt * M_2 PI) >= 4 / LDBL_EPSILON) 
errno » ERANGE; 
tn -= td; 
tn = xl.flt * M2 PI - tn; 
td = tn * tn; 
/* divide arg by 2 and rationalize numerator and denominator 
** numerator of rational approx for tan(x1/2) 
** Horner polynomials Ist time */ 
tn *= 886.77345 * TP4 + td * (-99.398954 * TP2 + td); 
/* denominator */ 
td = 686.77346 * TPS + td * 
(-394.98971 * TP3 + td * 14.425694 * T2PI); 
/* cos, sin half angle formulae, rationalized */ 
res.cosl] = (td * td - tn * tn) / (td * td + tn * tn); 
res.sinl = (tn * td + tn * td) / (td * td + tn * tn); 
/* copy 2 */ 
tn = x2.flt * M2 PI + (td = x2.iflt >= 07 
4/ LDBL_EPSILON =: -4 / LOBL_EPSILON) ; 
tn -= td; 
tn = x2.flt * M2 PI - tn; 
td = tn * tn; 
/* distribute terms to finish polynomials quicker */ 
tn *= 886.77348 * TP4 - td * 99.398954 * TP2 + td * td; 
rv = 886.77346 * TPS - td * 394.98971 * TP3; 
td = r+ td * td * 14,425694 * T2PI; 
res.cos2 = (td * td - tn * tn) / (td * td + tn * tn); 
res.sin2 = (tn * td + tn * td) / (td * td + tn * tn); 
return res; 


} 


/* End of File */ 
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Listing 6 (tan_2.c) 


typedef struct { 
double X1, X2; 

} ARG_D 2; 

ARG_D 2 

tan_2(xil, x12) 
double xil, xi2; 

{ 


/* vector 2 */ 


double x2, x, nl, x4; 
ARG_D 2 res; 
#include "float.h" 
#if FLT_ROUNDS != 1 
ferror "rounding mode not nearest; adjust code" 
fendif 
#if FLT_RADIX l=2 && FLT_RADIX l= 10 
ferror “code not optimum for accuracy in this 
RADIX" 
fendif 
#include <errno.h> 
#ifndef errno 
extern int errno; 
fendif 
finclude <math.h> 
fdefine M PI 3.14159265358979323846 
x2= (nl = (xid >071/ LOBL_EPSILON : 
~1 / LDBL_EPSILON)) + (x = xil) / M_PI; 
x -5 (x2 - nl) * MPI; 
if (fabs(xil / M_PI) >= 1 / LDBL_EPSILON | 
fabs(xi2 / M_PI) >= 1 / LOBL_EPSILON) 
errno = ERANGE; 
/* now in lst or 4th quadrant */ 
fdefine cO 33281881.3202530279 
nl = cO + (x2 = x * x) * (-15666569.8711211851) ; 
x4 = x2 * x2; 


res.X1 = x * (cO + x2 * (-4572609.43103684572) + x4 * 
(131095.887915363619 + x2 * (-968.863245687503149 + 
x2))) / (nl + x4 * (915701.668921990803 
+ x2 * (-13491,7937027796916) 
+ x4 * 44,4083322286368691) ); 
/* copy 2 */ 
x2 = (nl = (xi2 > 0? 1 / LOBL EPSILON ; 
-1 / LDBL_EPSILON)) + (x = xi2) / M_PI; 
x -= (x2 - nl) * MPI; 
nl = 915701.668921990803 - (x2 = x * x) 
* 13491.7937027796916; 
x4 = x2 * x25 
res.X2 = (x * (cO + x2 * (-4572609.43103684572)) + 
(131095.887915363619 + x2 * (-968.863245687503149 + 
x2)) * x4 * x) / (cO + x2 * (-15666569.8711211851) + 
x4 * (nl + x4 * 44,.4083322286368691)); 
return res; 


/* End of File */ 
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Summary 


Much of this article will appeal only 
to those who like to tweak code for 
another 20% in performance. I have 
concentrated on the points where ar- 
chitectural dependencies pop up and 
tried to show where their impact can be 
reduced for relatively small perfor- 
mance penalties. Math library functions 
are probably the closest thing to ap- 
plications where non-portable code is 
appropriate. This is the reason for these 
functions (at least the scalar versions) 
being defined in the C standard so that 
they need not be carried as part of on 
application. 

The extent to which special vector 
chunk functions should be used to per- 
form math library operations in groups 
may be questioned. An application 
which uses these functions probably 
should provide an alternative header 
file which will cause them to be 
replaced with standard functions. Com- 
pilers are most likely to begin to incor- 
porate such functions automatically if 
they produce benefits on the standard 
benchmarks. 

Scalar math functions can detract 
from the performance of superscalar 
processors. The techniques shown 
enable superscalar performance to be 
obtained in the evaluation of grouped 
math library functions. In typical ap- 
plications, the percentage of execution 
time spent in math functions can be 
reduced in comparison with a scalar 
processor. 0 
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memory, extended memory and disk. 

¢ Detects common heap errors like unfreed 
blocks, doubly freed pointers, and buffer 
overwrites. 


MoreHeap & SafeHeap Support: 


Call for free demo disks and literature. 
Visa/MasterCard/COD/POs accepted. 
Shipping and handling additional. 


Morelegp .......-sccsecssaes $135 
Safetleap ............ 895 ASIBHL .eeeeesenee $199 and Up 
Moretleap/Safetleap.......$179 


SafeHeap 
Memory Debugger 


¢ Just relink to include SafeHeap's validat- 
ing memxxx ( ) and strxxx( ) routines— 
rerun your application to produce a 
report of suspected buffer manipulation 
problems. No recompilation. 

¢ Documented interface for writing your 
own validating routines. 

© Small library. 

© Reports invalid reads/vrites to near/far 
heap, globals, and autos, including 
name of calling function, affected global 
variables and heap areas, and additional 
call statistics. 

° Zero overhead per allocation, uses HMA 
for storage. 

© Supports all memory models. 


Borland C++ and Microsoft C 


SeaBreeze Software Systems 
1330 Highway 206, Ste. 114 
Skillman, NJ 08558 
Sales/Support: 609 924 6793 


BREEZE BBS: 609 683 7701 
OFTWARE * =N5 
CET MARE CiS: 72330, 705 
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Porting Command Line 


William Smith 


Not very long ago the computer industry's direction con- 
cerning operating systems and user interfaces was uncertain 
and confusing. You had to be psychic, lucky, or just plain good 
at reading the writing on the wall to assess the direction the 
industry was going. To name just a few of the possibilities, 
there was UNIX and X-Window, OS/2 and Presentation 
Manager, MS-DOS and a primitive Windows 2.0, and MS- 
DOS and countless lesser known third party user interface 
libraries. Right at the height of this confusion, I was faced with 
choosing an operating system and user interface for a software 
development project. I was developing a data acquisition and 
data management system for an automated athletic weight 
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training system. The customer also wanted the program to 
have a modern graphical user interface (GUI). 

For economic reasons and availability of development 
tools, I decided to write the software in C for a target 80386 
personal computer running MS-DOS. The user interface 
decision was much harder. I, like many people when faced 
with a tough decision, decided not to decide. I made an en- 
gineering decision to do the user interface last. This allowed 
me to postpone the commitment to a specific user interface 
library. This was contrary to many opinions about designing 
software at the time. Instead of designing the software from 
the user interface and screen level first, I designed the 
software by identifying core functionality and operations inde- 
pendent of the user interface. To get the project going, I 
specified that the software was to be first developed using a 
simple command line interface (CLI). Later, when a graphical 
user interface library was chosen, I would port the program to 
work with the GUI library. As soon as a clear direction in the 
software industry emerged, I would decide upon what GUI to 
use. Much to my delight and the satisfaction of the customer, 
this approach eventually paid off. 

Well as most of you know, Windows 3.0 came out and 
quickly became a success. It became obvious what user inter- 
face to use. Eventually the project was over and the customer 
ended up with both a command line version and after a suc- 
cessful port, a Windows version of the software. Along the way 
I learned a lot about the approach involved in making this port 
easy. I am going to share with you some of what I learned 
about porting command line interfaces to GUI’s in general 
and Windows in particular. 

The concept of porting I am going to discuss 
requires work. It is not a simple recompile under 
a different environment. Granted, there are some 
features built into Microsoft QuickC for Windows 


William Smith is the engineering manager at Mon- 
tana Software, a software development company 
specializing in custom applications for MS-DOS and 
Windows. You may contact him by mail at P.O. Bax 
663, Bozeman, MT 59771-0663. 
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User Interfaces to GUIs 


and version 3.0 of Borland C++ that allow you to recompile 
your code under Windows with no changes. The approach is 
easy, but all it gets you is a command line within a window. I 
do not consider this a true GUI. To get true GUI behavior in 
your program you are going to have to write some code and 
,make some changes. GUIs are here to stay and will become 
increasingly popular in the future. The effort to port your code 
to a GUI is worth it. With proper planning, it does not have to 
be that painful either. 


CLI Versus GUI 


With the popularity of GUIs, CLIs may seem antiquated, 
but they have their place. They are easy to write and if you 
stick to the standard C library, very portable. You can 
generate a test program for exercising new code quicker using 
a CLI then a GUI. CLIs are fast and can be easy to use. All 
that the program requires of the user is to type in the program 
name and some options at the operating system prompt. The 
command line interface is elegant in its simplicity and ap- 
preciated by the skilled software user. CLIs are also very 
adaptable to batch mode processing. Unfortunately, CLIs are 
cryptic and require the user to have knowledge and memory of 
the command line syntax. By providing a help screen defining 
proper usage, you can relieve this challenge somewhat for the 
inexperienced user. An easy to use CLI program should pro- 
vide a provision to invoke this help screen when an A or ? 
option is passed on the command line. The program should 
also display the help information when there is an error in the 
command line syntax. 

GUIs are visually appealing and easier to negotiate then 
CLIs especially for the unskilled user. GUIs can require more 
steps to accomplish the same task then a CLI and are not as 
conducive to batch mode processing as CLIs. With some ef- 
fort, you can add key stroke short cuts and batch ability to 
GUIs to satisfy the demands of the advanced user. 


ee 
SERRE 
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Table 1 contains a list of user interface characteristics and 
features. It rates CLIs and GUIs for comparison. 


CLI Translated to GUI 


Programs in the simplest terms require input, perform 
some task and generate output. The input information is in the 
form of instructions and data. The output information consists 
of results and data. With a command line interface your 
choices of how to communicate instructions to a program are 
limited. Typically, CLIs use single characters, sometimes 
preceded by a delimiting character such as /, to specify op- 
tions, commands, or flags. The user passes data to CLIs in the 
form of file names or lists of strings. On the other hand there 
are many more options available on how to communicate in- 
formation to a program that employs a GUI. Table 2, lists the 
basic command line interface elements and corresponding 
GUI elements. The nomenclature is based on Windows. 
Notice there is not a one-to-one correspondence between a 
command line element and a GUI element. With a GUI, there 
can be many different ways to accomplish the same task. This 
gives the developer some flexibility in designing the interface. 

Listing 1 contains a code fragment from the main function 
of a program that processes a command line and performs 
database operations. This is an excerpt from a data base utility 
program that I first created as a CLI program and later ported 
to Windows. The command line is simple. To specify an opera- 
tion, the program requires a single character as the first argu- 
ment on the command line. The second and third arguments 
are a file name and a key name. The operation chosen deter- 
mines which of these last two arguments are required. 


Be 
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Table 1 


Characteristics / Features 


Ease of Development 

Portability 

Batch Processing 

Ease of Use 

Aesthetics and Presentation 
Visibility of Information 
Flexibility of Program Operation 
Numbcr of Interaction Steps 


User Interface Issues, CLI Versus GUI 


CLI Element 
Option / Action Flag 


Corresponding GUI Elements 


Menu Item, Radio Button, 
Check Box 
String Unlimited Choices |Edit Box, Check Box 


String Limited Choices Menu Item, Radio Button, 
List Box 


Edit Box, List Box, 
Dialog Box 


Editor, Dialog Box, 
Custom Builder 


CLI Elements and Analogous GUI Elements 


Listing 1 


File Name 


Script File 


ate ( argv[i] [0] ) 


case ‘a’: 
case 'A': 
Status = add data to_db( argv[2] ); 
break; 
case ‘d's 
case 'D's 
status = del_data_from_db( argv(2] ); 
break; 
case 'g': 
case ‘G's: 
status = get_data_from_db( argv[2], argv(3] ); 
break; 
case ‘I's 
case 'L'; 
status = list_keys_in_db(); 
break; 
case 'r'; 
case ‘R'; 
status = replace_data_in_db( argv[2]. argv(3) ); 
break; 
case ‘y's: 
case ‘Y's: 
status = vrfy data_in_db( argv(2], argv(3] ); 
break; 
default: 
status = FAIL; 
break; 
)  /* switch ( argv[i] [0] ) */ 


/* End of File */ 
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Listing 2 


switch ( wParam ) 


case IOM_ADD: 


/* Select a File */ 


status = FileSelectDialog( hInstance, hWnd, 


Caption, FileSpec ); 


if ( status == FAIL || status == FALSE ) 
break; /* Canceled the operation. */ 


/* Add file to database */ 


status = add data_to_db( FileSpec ); 


break: 


case IDM DELETE: 


/* Select a Key */ 


status = KeySelectDialog( hinstance, hWnd, 


Caption, Key ); 


if ( status == FAIL {| status == FALSE ) 
break; /* Canceled the operation. */ 
/* Delete Keyed Data from database */ 


status = del_data_from_db( Key ); 
break; 


case IDM GET: 


/* Select a Key */ 
KeySelectDialog( hInstance, hWnd, 
Caption, Key ); 


if ( status == FAIL || status == FALSE ) 
break; /* Canceled the operation. */ 


/* Select a File */ 
FileSelectDialog{ hInstance, hWnd, 
Caption, FileSpec ); 


if ( status == FAIL || status == FALSE ) 
break; /* Canceled the operation. */ 


/* Get data from database and store in File */ 


status = get_data_from_db( Key, FileSpec ); 


break; 


case IDM REPLACE: 


/* Select a Key */ 
KeySelectDialog{ hInstance, hWnd, 
Caption, Key ); 


if ( status == FAIL || status == FALSE ) 
break; /* Canceled the operation. */ 


/* Select a data file */ 
FileSelectOjalog( hInstance, hWnd, 
Caption, FileSpec ); 


if ( status == FAIL || status == FALSE ) 
break; /* Canceled the operation. */ 

/* Replace Key data with data in FileSpec */ 

status = replace _data_in_db( Key, FileSpec ); 


break; 


case IDM_VERIFY: 


/* Select a Key */ 
KeySelectDialog( hInstance, hWnd, 
Caption, Key ); 


if ( status == FAIL || status == FALSE ) 
break; /* Canceled the operation. */ 


/* Select a File */ 
FileSelectDialog( hInstance, hWnd, 
Caption, FileSpec ); 


if ( status == FAIL |] status == FALSE ) 
break; /* Canceled the operation. */ 
/* Verify Data in database (Key) matches 


** data in FileSpec */ 


status = vrfy_data_in_db( Key, FileSpec ); 


break; 


default: 


) 


status = FAIL; 
break; 
/* switch ( wParam ) */ 


/* End of File */ 
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The command line syntax is 
PROGRAM OPERATION FILE KEY 


The possible operations are shown in 
Table 3. 

Listing 2 contains an excerpt from a 
Windows program. This code is taken 
from a program that accomplishes the 
same tasks as the program that contains 
Listing 1 . The code is from the win- 
dows procedure for the main window 
that responds to messages for the main 
window. The code fragment contains a 
switch statement that reacts to menu 
choices that are in the form of messages 
communicated from Windows. There is 
correspondence between the command 
line options and the menu choices. The 
user specifies the file and key through 
interaction with dialog boxes. Notice 
that the calls to the functions, 
add_ data to_db, del_data_from_db, 
get_data_ from_db, 
replace_data_in_db, vrfy_data_in_db 
are the same for both the CLI version 
and the GUI version. The code for 
these function should be portable across 
user interfaces. 

Table 4 lists the CLI arguments and 
the corresponding GUI elements used 
to accomplish the same operations. 


GUI Portability Strategy 


There are three major guidelines 
that form the foundation of a strategy 
for portability between user interfaces: 

1. Identify high level functionality 
and data structures 

2. Isolate program functionality from 
user interface code 

3. Use standard library and standard 
types 

Planning for user interface por- 
tability requires adopting a design 
philosophy of first identifying high level 
program functionality and avoiding the 
specifics of screen design. The idea is to 
isolate the major data structures and 
operations that the program supports. If 
you can wrap a command line interface 
around the operations that your pro- 
gram performs, you are on the right 
track. Granted some programs such as 
word processors do not lend themselves 
to command line interfaces. Even in this 
situation, you can isolate individual 
functions a word processor performs 
and group them in a utility program 
with a command line interface. 
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Table 3 


add data contained in FILE to database 

delete data specified by KEY from database 
get data specified by KEY from database and 
store in FILE 

list all the keys in the database to standard output 
replace data in database specified by KEY 
with data in FILE 

verify data in database specified by KEY with 
data in FILE 


strongly segregate the code you write to implement this 
functionality from the user interface code. The modules that 
contain the core operations of your program should be port- 
able and not make any function calls to a user interface 
library. 

To help with portability, use the standard library functions 
and the standard types. Some of the issues encountered when 
porting among GUIs and operating systems are sizes of stand- 
ard types, structure packing, and alignment. The size of some 
of the standard types will change from one platform to 
another. An example is the default int type. Under some com- 
pilers an int is 16 bits while with others it is 32 bits. If you do 
not care what size it is and want to use the native most effi- 


- Soft 


SofiC is the database library of choice for 
professional C & C+ + developers. It 
offers unsurpassed speed and flexibility 
along with access to industry standard 
files at a very competitive price. 


e Full compatibility with dBASE, Clipper, 
Alpha IV, FoxBASE+ & FoxPro. 


° Portable to DOS, OS/2, UNIX & XENIX. 


e Included Windows DLL is linkable with 
Visual BASIC, Turbo Pascal for Windows, 
& other DLL-capable compilers. 


e Single/multi-user & network access 
supported. 


* 100% C source code (both ANSI & K&R). 
| e No Royalties. Version 3.0 now shipping. 


Iqr] osequieq 


30 day money 
back guarantee. 


(612) 484-6968 


Call about Special 
Pricing for Windows DLL 
& DOS object code 
libraries. 


Complete Source & Windows DLL 


for only: $ 1 95 


KYFFAZ@| 19820 Third Stoct Northeast 
0 Anoka, MN 55304-4703 U.S.A. 


| ee Fart (612) 434-S023 
>I 
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Table 4 


Options (Menu) 
Add... 
Delete... 
Get... 


CLI Arguments 


Replace... 
Verify... 


iy 
File Select Dialog Box 
Key Select Dialog Box 


CLI Arguments and Corresponding GUI Elements 


cient size, use just a plain int. If you only need 16 bits and 
want to conserve space in a platform where int is 32 bits use 
short int. If you need 32 bits even in a platform where int is 
16 bits use long int. Avoid typedefing int and encoding the 
size in the type such as int16 or int32. Some claim that this 
increases portability, but I have found the exact opposite to be 
true. I also recommend using the size_t type defined in 
standard C. size_t is defined as an unsigned integer. It is con- 
venient to use variables of type size_t as array indexes. 

Related to type size is structure packing and alignment. In 
most situations, compilers align structure members (except 
chars) on boundaries that correspond to the most efficient 
type size. On a 16-bit system, structure members are aligned 
on word boundaries. On a 32-bit system, structure members 
are aligned on double word boundaries. Some compilers allow 
the program to control structure alignment. 

Try to avoid dependencies in your code on type size and 
structure alignment. The sizeof operator can help with types 
and the offsetof macro can help with structures. Pay careful 
attention to third party libraries if you use them. They may 
have size and structure alignment dependencies that could bite 
you later. 

Buffer sizes and string lengths should be set using manifest 
constants. For example, the maximum length of a string to 
hold a file name may change from one system to another. It is 
far easier to change the definition of a manifest constant in 
one place than find all places where space for a string is allo- 
cated. 


Porting to Windows — the Gruesome Details 


Since Windows is such a popular GUI, it is worth talking 
about some of the specific issues encountered when porting 
existing C code to this environment. As a first step in porting 
your CLI program to the Windows GUI, you may want to cre- 
ate a user interface shell and spawn the CLI version of your 
program using the Windows WinExec function call. WinExec is 
similar to the spawn function family in standard C. This ap- 
proach will get you up and running, but I found it unaccep- 
table for a finished product. The major drawback is the lack of 
and the difficulty involved in communicating between MS- 
DOS and Windows programs. 
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Microsoft QuickC. 
for Windows 


Use QuickCase:W to draw the graphical elements of 
your Windows program, from menus and 
dialog baxes to cursors and icons. Then, 
let QuickCase:W generate commented expert-level C 
source code for the design that you've created. 


Pesan? = 
[Bile Can Yirw —Grojecs Dum Rebuy ici Qpuene Window teip 
| Fests: [cower Ts] mee [it JO] (ley siege) 


QuickC for Windows supports a wide range of 
breakpoint types, from breaking at a location to breaking 
on a Windows procedure when a message ts received. 


ee PROGRAMMER’S TIPS 


Key Features 


® Windows-hosted integrated development 
environment including an editor, compiler, 
and debugger. 

© All you need to write a Windows-based 
program. 

© QuickCase:W generates source code from 


your program design and regenerates the code 


if you change the design. 

e Wide range of breakpoint support, including 
breaking at a location, breaking when an 
expression has changed, and breaking at a Win- 
dows procedure when a message is received. 

¢ Complete printed and online documentation 
on the Windows API. 
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DEVELOPMENT 
EO Ot 8. 


Graphic proof that developing 
Windows apps is now easier. 


Take a look at Microsoft? QuickC’ for Windows" 

Its Windows-hosted, so you can edit, compile, and debug 
inside a single environment. Click on the Toolbar™ to choose 
frequently-used functions, from changing fonts to setting break- 
points. Workspace templates let you save your screen layouts, 
so you can reload them quickly from another session. 

Plus, a remarkable tool known as QuickCase:W lets 
you create every element in your user interface with a few 
strokes of a mouse. Then it automatically generates the C source 
code you need. 

All of which lets you create more applications. And more 
kinds of applications: C programs that call Windows APIs, 
graphical front-end programs for FORTRAN and COBOL, 
and C DLLs for other programs. 

We suggest a visit to your Microsoft dealer. Because 
with QuickC for Windows, seeing is believing. 


© 1991 Microsoft Corporation. All rights reserved. Printed in the USA Inside the 50 United States, call (800) 541-1261, Dept. R22; outside tha 50 United States, call 
(206) 936-8661 In Canada, call (416) 568.3503. Microsoft, CodeView, MS-DOS, QuickC and the Microsoft logo are registered trademarks and Windous, ard 
Teothar are trademarks of Microsoft Corporation. “As used herezn, “DOS™ refers to MS-DOS and PC-DOS operating nsterns, 


e To rebuild your character-based 
DOS applications to run under 
the Windows environment, select 
the “QuickWin EXE” Project type 
in the Options menu. 

© Use the new and improved Dialog 
Editor to quickly and easily design 
dialog boxes for your programs. 


Microsoft 


e Toolbar for quick access to frequently used 
editing and debugging functions. 

e Save Workspace and Load Workspace for 
saving and restoring window positions and 
breakpoints. 

© Syntax highlighting in editor 

© Customizable tools menu allows you to run any 
Windows or DOS’ program from within the 
QuickC for Windows environment. 

© QuickWin library for converting well-behaved 
C programs for DOS to Windows programs. 

® Generates Windows Executables, Windows 
Dynamic Link Libraries, QuickWin Execut- 
ables for the Windows environment, and 
MS-DOS? Executables. 
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Real-Time Graphics and 
Measurement/Control Tools 


Programmers Tools for Microsoft C, Turbo C, C++ and Turbo Pascal 


Duno Test Eng #1 Duno Test Eng #82 


Pres 2, poOasy 
‘eae 410.4 || 492.6 bea © ||ipac | 
Um | Pen. Fenr. 


Call or Write for Demo Disk 
Fast Real-Time Graphics 


Real-time graphics routines for scrolling graphs, sweep graphs, process control bargraphs, annunciator panels, 3 
types of meters and general graphics text displays. Real-time mouse routines are also included. The routines are 
optimized around the graphics primitives which come with the respective compiler. 


Powerful Measurement and Control 

PID Control (position and velocity algorithms), Thermocouple linearization for the 15 standard TC types (B, BP, 
BN, E, J, JP, JN, R, K, KP, KN, S, T, TP, TN), Thermocouple curvefitting for any temperature range, Fourier 
analysis routines including 16K point FFTs. 


Source Code and Royalty Free 
No additional charge for source code, use these routines in your programs without worrying about royalty fees. 
No other third party drivers are necessary. 


Each version is $200 


Please specify compiler when ordering. 
Price includes libraries, source code and a 300 page manual. 
Mastercard, Visa accepted. Shipping charge $5 within USA, $9 Canada and $25 elsewhere. 


Quinn-Curtis, 21 Highland Circle, Needham, MA 02194 USA Tel. 617/449-6155 FAX 617/449-6109 
~ Request 129 on Reader Service Card + 
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The next step is to replace the CLI interface and compile 
your code as a Windows application. Unfortunately, even if 
you prepared ahead for portability there are some problems 
that may surface. 


Types and Structure Alignment 


I have already mentioned data types and structure packing. 
They are especially important issues under Windows. Win- 
dows, in its present incarnation, is a 16-bit environment and 
the default int type is 16 bits, but Windows requires structures 
to be aligned on eight-bit (byte) boundaries. If your code ex- 
pects structures to be aligned on 16-bit (word) boundaries this 
may affect you. I ran into alignment problems with a third 
party database library. The situation forced me into hand pad- 
ding my structures so members greater than a single byte in 
size were aligned on word boundaries. I inserted eight-bit pad- 
difig members of type char after an odd number of single byte 
members, 

The Windows programing environment contains many new 
types defined in the include file, WINDOWS.H. I recommend 
you use these types, but confine their usage to the user inter- 
face portions of your code. 


Memory Models 


Since Windows runs under MS-DOS and is subject to the 
caveats of the Intel segmented architecture, you will have to 
deal with near and far pointer issues and memory models. 
Since I wanted as much of my code to 
be as standard C-like as possible, I tried 
to avoid sprinkling my code with the 
keywords near and far that are not 
standard C keywords. The general wis- 
dom on Windows claims that programs 
compiled using the small or medium 
memory model behave better under 
Windows than those compiled with the 
large or compact memory models. 
Using the small or medium memory 
model forces you to declare pointers 
with the far keyword if they happen to 
be in far heap space. Even though using 
the large and compact memory models 
is discouraged, many of the Windows 
library functions also require far 


implementation of the large and compact memory models. 
Microsoft C creates multiple data segments when using the 
large or compact memory model and you have little control 
over the outcome. Borland C++ creates a single data segment 
unless you specifically tell it to create more. You can run mul- 
tiple instances of a program compiled under Borland C++ 
using the large or compact memory model. The exact program 
compiled with Microsoft C using the large memory model will 
run as a single instance only. 

I have tried the large memory model under Windows and 
did not notice any performance problems with Windows in 
standard or enhanced mode. I never even tried real mode. 
Since Windows 3.1 eliminates real mode, I probably never will 
use real mode. If you need pointers to far data, your choices 
are to use the large memory model or to use mixed model 
programming by declaring pointers with the far keyword. 


Dynamic Memory 


Windows does support the malloc family of standard C 
library memory management functions. Unfortunately, they 
may have slightly different behavior then what you are use to. 
Depending on the memory model, malloc may allocate 
memory in the near heap. If you want to force allocation in 
the far heap independent of memory model, you will have to 
use the function _fmalloc, Since Windows maps _fmalloc to 
the Windows function GlobalAlloc, there is a limitation on 
how many times you can call _fmalloc. Every time you call 


... LHE HIGH POWERED 
DOCUMENTATION TOOL 


pointers as parameters. The only way to 
get far pointers without adding the far 
keyword to every declaration is to use 
the large or compact memory model. 
Windows does not like programs com- 
piled under these memory models be- 
cause they may contain multiple data 
segments. Windows fixes multiple data 
segments in memory. This situation 
prevents Windows from running more 
than one instance of such programs and 
may cause inefficiencies in Windows 
memory management. This is the case 
with Microsoft C, but not always with 
Borland C++. Yes, that is right, the 
two compilers have a slightly different 
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You have been handed a few inches of source code and 
have been asked to modify it. C/ANALYST can quickly 
bring you up to speed. It analyzes your C source and 
forms a database representing your entire program. 
From this database, your program can be exhibited 
from different perspectives. 


C/ANALYST is a set of four programs: ANALYZE, 
XREF, PROCTREE, and DATAFLOW. 


ANALYZE creates the database from your source files. 
A virtual memory manager is used to allow quick 
access to a large data space. ANALYZE supports ANSI 
C with extensions for popular compilers. Many 
customers report that analysis of their source code 
caught errors they were unaware of. 


XREF generates a function index followed by a global 
cross reference listing. The function index 
alphabetically lists each function, gives its location and 
its definition taken from comments in the source code. 
The global cross reference shows where each object is 
used and how it is used as well. Read and write codes 
are included with each reference to a variable, function, 
or member. 


PROCTREE generates tree diagrams which show the 
overall control flow of the program. Diagrams can be 
printed sideways on dot matrix printers or the HP 
Laserjet. Large diagrams can be created for group 
display or the diagrams can be printed on individual 
pages with annotated connection circles. 


DATAFLOW analyzes and lists possible datapaths 
between source modules in the program. including 
flow through global variables, parameters to 
functions, return values from functions, and aliases of 
formal parameters which are pointers. 
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GlobalAlloc, Windows uses a segment selector. There is a 
finite number of segment selectors available. This happens to 
be 8192 for all of Windows — not just your application. If your 
program requires the allocation of a lot of small pieces of 
memory, you can quickly run out of selectors even if you still 
have lots of free memory. The solution to this problem is to 
call GlobalAlloc sparingly and use subsegment allocation. 
This means you will have to write your own memory manager 
or buy one of the third party libraries on the market. Version 
3.0 of Borland C++ supports subsegment memory allocation 
and eliminates this problem. I expect eventually all compilers 
that support Windows will support this feature. 


WINSTUB. EXE 


Windows allows a non-Windows program to be bound to 
your Windows program. You specify the stub program in the 
linker definition file. MS-DOS executes the stub program 
when you invoke the program from the MS-DOS prompt. I 
took advantage of this feature to bind the command line or 
MS-DOS version of a program to the GUI or Windows ver- 
sion of the same program. The only problem I encountered 
with this was that Borland C++ enforced a 64KB maximum 
size limitation on the stub program. Microsoft C allowed the 
stub program to be any size. 


UAEs and New Bugs under Windows 


When I first compiled my program under Windows as a 
Windows application, I was extremely disappointed when it 
would not run without generating UAEs (Unrecoverable Ap- 
plication Errors). Upon tracking down the offending lines of 
code, a pattern started to emerge. The majority of the UAEs 
where caused by dereferencing null pointers. This was occur- 
ring in the code I had written and also in the standard library 
code that I was passing null pointers to as parameters. Since 
the program worked fine under MS-DOS, there was some ar- 
gument among co-workers about whether these were actual 
bugs. One of my partners claimed that functions such as 
strcmp should be able to handle a null pointer parameter. 
Since I could not find any reference that specified how some 
of the standard library functions responded to null pointers as 
parameters, I decided to be conservative on this issue and ac- 
tually modified the program’s code to avoid passing nuil 
pointers to functions where the behavior was not defined and 
caused UAEs. I recommend that you be careful about 
dereferencing null pointers and passing null pointers to stand- 
ard library functions where the behavior is not specifically 
defined by the standard or defined in the function description 
that comes with your compiler’s documentation. 


Conclusions 


Ease in portability between user interfaces requires planning. 
A decision to first develop an application 
with a command line interface and then 


Get Byte-BOS" and leave 
the MULTITASKING to us! 


port it to Windows made me deal head 
on with GUI portability problems. What 
I eventually ended up with is a program 
where most of the code will port to any 
GUI without rewriting it. 

Planning for portability requires you 


Why spend months designing, documenting, coding, and debugging a 
multitasking kernel when you can have Byte-BOS, a widely used 
multitasking operating system on your desk tomorrow? 


Byte-BOS Multitasking Operating System consists of a complete set of 
integrated multitasking components including a robust kemel, "add on" 
libraries, and development tools that run on a PC. 


Only $995 buys our multitasking kemel with all these features: 


D preemptive task scheduling 
O task management 

© event management 

O message management 

© timer management 


O resource management 

© application code & user manual 
© configured to your C compiler 

© no royalty C source code 

© 1 year of tech support & updates 


Add these multitasking libraries to suit your application: 
© "on chip” serial VO manager 


© external serial I/O manager 
© fixed block memory manager 


© multiple message buffer manager 
© multiple timeout manger 
© dynamic task manager 


Develop and debug Byte-BOS applications on a PC with these tools: 


D5 BOSPCX for target prototyping © BOSVIEW multitasking debugger 
Byte-BOS is available for a wide range of microcontrollers and the PC. 
Our technical support is responsive, friendly, and knowledgeable. Call us 
today and see how easy multitasking can be with Byte-BOS. 


on ae Neo 800-788-7288 or 619-755-8836 


integrated 
PO Box 3067 Del Mar CA 92014 
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to identify the needed operations and 
the high level data elements inde- 
pendent of any user interface issues. 
You should isolate user interface 
specific code from the core program 
code. You should be able to access the 
functionality of your program through a 
simple command line interface. This can 
be handy for testing. For a CLI, the 
main function should do nothing but 
process the command line and make the 
requested function calls. These same 
function calls can then be called in a 
similar way when responding to -mes- 
sages or events in a program with a 
GUI. The GUI program will have to be 
more than just a simple main function 
module and may require many new 
modules that support the GUI 
functionality and screens. The goal is to 
have the business end of the code that 
does the data crunching and calculating 
remain unchanged when porting from 
one user interface to another. 0 
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A Versatile Menu Program for Turbo C 


Roger T. Stevens 


Introduction 


Although there are menu programs available commercially 
and as shareware, most of them provide only the capability to 
display and select from a list of menu items, and do not permit 
interaction with the display. However, interaction with the dis- 
play is often essential for efficient operation of a program. 
Look at the sample display of Figure 1. The two bottom lines 
are provided by the menu function. They give the user the 
choice of the actions: DISPLAY DATA, CHANGE DATA, ADD DATA, 
or QUIT. All you can do with most menu functions is to select 
one these actions. However, for the first two of these actions, 
we want to interact with the display, by selecting a name from 
the list for the action to be performed upon. The menu func- 
tion described below will automatically switch mode after an 
action is selected. For the first two actions, the new mode can 
permit scanning the list of names with the up and down cursor 
arrows, highlighting each in turn with a contrasting color com- 
bination. The user then hits ESC to activate the selected func- 
tion. The cursor is only permitted to go to the first letter of 
each name in the list. 

Now look at the display of Figure 2. This is a new user 
generated display which provides detailed data on the person 
selected from the first display. Again the menu function is ac- 
tivated; this time it just displays two lines of instructions at the 


bottom of the screen. This is the display that you see if you 
chose the action CHANGE DATA, from the first display. Those 
places on the screen where you are allowed to change the data 
are actually shown on this display in a different color from the 
rest of the display and the cursor is restricted to only these 
positions. After you have modified the data in any way you 
desire, hitting ESC returns to the main program. The user can 
then arrange to read any data changes from the screen into his 
data files. Note that as long as you are within the menu func- 
tion, you have the capability to move the cursor to any permis- 
sible location and change or rechange the data there. If at the 
first screen, you selected the DISPLAY DATA action, the bottom 
explanatory lines simply say Hit any key to continue... and no 
modification of display data is permitted. 

For the ADD DATA action, no selection from the list of 
names is permitted; instead the display immediately switches 
to that of Figure 2, but with the data areas blank, ready to 
receive data on a new person. 

All of the menu and display interaction is controlled by a 
versatile menu function which provides a number of different 
modes of operation through passed parameters. This menu 
function is described in the text that follows, and the code is in 
Listing 1. The listing also includes a number of useful func- 
tions needed for program operation. 


Dr. Roger T. Stevens is a member of the technical staff of the MITRE Corpora- 
tion, Bedford, MA. He holds a B. A. degree in English from Union College, an M 
A in Mathematics from Boston University, an M. Eng. in Systems Engineering 
from Virginia Tech, and a PhD. in Electrical Engineering from California Western 


University. Dr. Stevens’ books Graphics Programming in C, 


Fractal Programming in C, and Fractal Programming in Turbo 
Pascal are published by M & T Publishing, Inc., 501 Galveston 
Dr., Redwood City, CA 94063. 
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Figure 1 


List of Names 


John S. Jones 

Arthur €. Smith 
William S$, Thompson 
Thomas F. Doughty 
Edgar Snow 

J. Theophilus Johnson 
Peter T. Timkins 


Select desired menu function with cursor arrows - then hit ‘Enter' 
DISPLAY DATA CHANGE DATA ADD DATA QUIT 


Name List Display 


What You Can Do with the Menu Program 


The menu program begins by displaying two adjacent lines 
of instructions or menu items on the screen. You can select 
the location of the first of these lines by setting a parameter 
called first_line_loc, which is passed to the menu function. 


Don’t waste any more of your time, let 
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GENMAKE will: 
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To order 
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Name: John S. Jones 
Address: 132 Main St. 
City: Rutland State: VT Zip: 


Phone: (802)555-6432 


Change data as required: 
“| Then hit 'Esc'. 


Display of Detailed Individual Data 


The first line normally consists of general instructions; the 
second line, which is the next line after the first line, can be a 
list Of menu items from which the user makes a selection, or 
can be another set of general instructions, depending upon the 
mode of operation of the menu program. 
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Meijin++ 2.0 
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with 80 examples. 30 day Money Back Guarantee. i 
| MS-DOS/WS, Unix V, Sun - Starting: $349 (Source included) 


Network Integrated Services, Inc. 
221 West Dyex Road as 
Santa Ana CA 92707-3426 Die 
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The best C/C++ 
tools for Windows are 
from the company that 
makes Windows. 


Table 1 


FOREGROUND 
| Bright White 
Yellow 


Light Cyan 
Light Blue 


pan 
loa 


i 


_ 
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> 


Color Table | 


TRAPPED 


BETWEEN PIRACY AND PROTECTIONS 


Vault has it all. Why go anywhere else? Use our patented disk-based 
products and make yourself a hero by adding as much as 60% of 
your copy protection dollar to your bottom fine. Your customers will 
love you for it -no more misbehaving printers, sleeping output ports, 
clunky dongles on laptops. 


There is an inexpensive, no hasste solution. If you object to copy 
protection because of its history of incompatibility and you don't 
want to make your lawyer rich sueing your biggest customer, try our 
dongle on a disk combo. It automatically checks the hard disk for an 
installed program, the paralfel port for a Romlok, and finally the disk 
drive for a Profok disk. And, it works every time. We guarantee it. 


© Prolok Patented disk-based copy protection 

© Romlok Hardware security device 

© Nolok Prevents disassembly or modification of your code 

© Unilok Protection on networks and frequently updated 
software. 

© Chronolok — Execution counter for perishable or demonstration 
software 

© Netlok The generic network management and control 
system 


*Easy lo use °No source code changes required *100% compatible. *Patented technology 
"Supports duplication equipment. *Linkable object modules lor austom security. "Hard disk 
installable, "Solutions for every operating system environment. *Fully functional evaluation 
kits available OS, and Windows support. 
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Introducing Microsoft C/C++. 


Microsoft Borland’ By almost any measure, new Microsoft’ 
Windows Glass Libraries C/C++70  BC+3.0 C/C++ Version 7.0 development system for 
_ Covers entire Windows API ie n .. Windows” is the best way to create all your 
Menucinaos oy N ae a the Windows and MS-DOS’ 
operating systems. 
GDI t Y : 
renin oa y With better code generation and pre- 
_ OLE 1.0 support eo eS oe compiled headers, you'll have all the tools you 
_ Exception handling x N need to write better code, faster. 
_ Diagnostics support Y N And because the Microsoft Foundation 


Classes have the most complete framework for 
Seas | Windows, you'll use the same building blocks 
(Encryptionslest Oe) ixe-a0) for your products that we use for ours. 
EXE size rr rs C/C++ 70 also includes the Windows 
aaameet ay — 3.1 debugging kernel which can help you find 
_ERBEOSOMIE SER SEE IESE the bugs. Plus, all the tools you'll ever need to 
edit your resources, compile the help files and 


Woods Generations DES) 


BYTE Build ‘Test CYTE} ~=—s even build your very own graphical setup pro- 
Using fast compile, 300sec  420sec, #$gramsfor Windows. 

i, Pre-compiled headers : | | Judge for yourself. Try new Microsoft 

| OptimizedEXEsize ss‘ 624K 2026K_—s« C/C++ 70 and, as a Microsoft, Borland or 


Zortech customer, you'll be able to upgrade for 
eee) «just $139°— and for a limited time, you'll geta 
free copy of Qualitas’ 386 MAX” in the box! 


~@ompiler Features 


Code in pre-compiled headers Y N 
fone So call your 
eae ASS Mee Y . _N__. - Jocal reseller now, 
_ Auto-inlining ater tage or call Microsoft at 
_ P-code x Nigse (800) 541-1261, 

Department Z69. 

Windows ‘Tools C/C+70 BC+3.0 Get your to ols from 

nie 3 re the people who 
| indows resource ‘ . 2 

editing tools ae make bee be 

Profiler for Windows Y Y build we ve een 
| & MS-DOS uilding Windows 
- Windows Help compiler 2g ¥ tools longer. ane 
| Windows setup builder ye ES ON 
Totaldocumentation 5408pp 4038 pp_ Upgrade for just $1301 
Windows 3.1 Y $199 | 
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“BtalPrie’ 8495 S048 Microsoft 
‘Reseller prices may vary. Offer good only in the 50 United States. ©1992 Microsoft Corporation. All rights reserved. Printed in the USA. In the 50 United States, call (800) 5-41-1261. Dept Z62. Por information only: In Canada, eal (800) 563- 
Frinies ibe apf Api yeropi ty pe abn SG Seer ond BOS reed demas and Wines ara Aire Coporatn: Al conpartos nh Borands Cm Comer eg — 


April 1992 The C Users Journal — Page 45 


/* 


Listing 1 


menu = controls cursor movement and menu display and selection - 
returns the number of the selected menu item. 


values: 


menu_first_line: 


menu_second_line: 


screen_first_line: 


screen_second line: 


menu_type: 


screen_color: 
menu_color: 


highlight_color: 
select_no: 


escape_char: 


map: 


*/ 


a string consisting of two digits showing 
the number of menu choices, followed by 
four digits for each choice, the first 
two showing the starting column of the 
menu item and the second two its length. 


the first line of instructions in the 
menu mode. 


the second line in the menu mode. It con- 
tains the menu choices. 


the first line of instructions in the 
screen mode. 


the second line of instructions in the 
screen mode. 


O: Start with Menu Mode. 
Alphanumeric characters are ignored 
when entered in screen mode. 

1; Start with Menu Mode. 
Alphanumeric characters are displayed 
when entered in screen mode 

2: Start with Screen Mode. 
Alphanumeric characters are ignored 
when entered in screen mode. 

3: Start with Screen Mode. 
Alphanumeric characters are displayed 
when entered in screen mode. 


color for screen mode. 
color for menu display. 


color of selected menu item 
number of menu items using selection 


number of the key selected for escape 
from the screen display. 


bit map of permitted cursor locations. 
The cursor will go to permitted locations 
only and no others. 


int menu(char values[],char menu_first_line[},char menu_second_line{], 
char screen_first_line[] ,char screen_second_line[],int menu_type, 
int screen_color,int menu_color,int highlight_color, int select_no, 
int escape char, int first_line_loc, char map[25] [10]) 


union REGS reg; 


int i,choices,indx,start, length,menu_second_line_length; 
int interim,remainder,temp; 
char spaces[80] ,prev_char; 


for (i=0; i<76; i++) 
spaces(i] = ' '; 


spaces(76] = '\0'; 


menu_second_line_length = strien(menu_second_line); 
gotoxy(2,first_line_loc); 


choice = 1; 
if (menu_type <= 1) 
{ 


color_printf("%s",menu_color,menu_first_line); 
gotoxy(2, first_line_loc+1); 

length = values(4] - '0'; 

length = 10 * length + values([5] - '0'; 
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You can specify the color combina- 
tion for the menu items and the color 
combination which is used to highlight 
the currently selected menu item. The 
rest of the screen display remains as you 
generated it before calling the menu 
function. A menu item is selected by 
use of the cursor arrows; when selection 
is complete, this phase of the menu pro- 
gram is terminated by hitting the Enter 
key. For any number of menu items, 
beginning with the leftmost, you can 
specify an alternate (screen) mode of 
operation, which is entered after the 
Enter key is hit. You can specify each 
permissible cursor position for this al- 
ternate mode, and the cursor will only 
be allowed to go to these selected posi- 
tions. (For example, if the down arrow 
is hit, the menu function will look at the 
current column and the next line and 
move the cursor there if it is a permis- 
sible position. If that position is not per- 
missible, the function will look for the 
nearest permissible position on that 
line; if there is none, it will look at the 
next line, and so forth until a permis- 
sible location is found.) You can also 
specify two lines of text which will ap- 
pear on the menu lines when the alter- 
nate mode is entered. You can specify 
whether this alternate mode of opera- 
tion will be a select or anenter text 
type of operation. If selection is chosen, 
the text from the cursor to the next oc- 
currence of two adjacent spaces is high- 
lighted. Usually for this type of opera- 
tion, the only allowable cursor positions 
are at the beginning of each selectable 
item on the display, so the entire 
selected item is highlighted. 

If you specified the enter text type 
of operation, the user may enter al- 
phanumeric data in any permissible cur- 
sor location. You may specify the color 
combination which this entered data will 
have. When data entry is complete, the 
same escape character specified above is 
used to terminate the screen mode of 
operation. 


Determining Permissible 
Cursor Positions 


The heart of the menu program is 
the capability to specify which positions 
on the screen the cursor is permitted to 
occupy. When in the selection mode, 
there should only be one permissible cur- 
sor position for each item to be selected. 
That is usually the first character of the 
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item description. When changing or 
entering data on the screen, a file struc- 
ture is usually determined, which 
specifies the names of the data items for 
each file entry and the length of each of 
these items. A display location and 
length is established for the display of 
each item, and the cursor is only al- 
lowed to go to the allocated space for 
each item. These areas of the screen 
can then be read to obtain the modified 
data. By prohibiting the cursor from 
going to other areas, it becomes impos- 
sible for the user to overwrite item 
definitions or to enter data that is too 
long to fit into the file. 

The permissible cursor positions are 
controlled in the menu program by use 
of a bit map, which contains one bit for 
each character position on the screen. 


Listing 1 — Cont'd 


for (indx = 0; indx < menu_second_line_length; indx++) 
if (indx < length) 
putcolorchar(menu_second_line[indx], 
highlight_color); 
else 
putcolorchar(menu_second_Tine[indx], 
menu_color) ; 


color_printf(screen_fi rst_line,menu_color) H 
gotoxy(2,first_line_loctl); 
color_printf(screen_second_line,menu_color); 


choices = 10 * (values(0) - '0') + values[1] -'0O' 
gotoxy (column, row); 
for(;3) 


key_id = getch(); 
if (key_id == 0) 
key_id = getch()+256; 


The bit map consists of a character 
array of 25 by 10 characters. The 25 is 
for the 25 screen lines; the 10 is for ten 
bytes of eight bits each to provide for 
the 80 character positions on a line. 

If a particular bit is one, the cursor is 
permitted to go to that location; if it is a 
zero, the cursor is prohibited from going 
there. The bit map for a particular menu 
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if (menu_type <= 1) 
{ 


switch(key_id) 
{ 


case 13: 
if(choice > select_no) 
goto ExitPoint; 
change_line color(47); 
gotoxy(2,23); 
color_printf("%s",screen_color, spaces) ; 
gotoxy(2,23); 


C++ IMAGING 


moin() 
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vimage cant 
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maint) 
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/fremave face from image » 

wei b= oosi{256,200, ed 428); ; 
//magnify by interpolation - 7. 
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IF YOU PROGRAM 


in C, C++, Basic, Fortran, Cobol, 
Pascal, dBase, *.* 


HI-SCREEN Proll” 


is your user interface solution 


With HI-SCREEN Pro Il, you con design modern 
text and graphic user interfaces in a snap: 


> Design interface one using interactive 
editors. Generate all windows, icons, menus, 
and data entry screens in a WYSIWYG foshion. 
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windows with scroll bors & boxes © Automatic 
shadowing effects © Combine text and graphics © 

Copture ony text ond me screens © Flexible input 

ela field-by-field or full-screen, interrupt 
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Listing 1 — Cont’d 


color_printf("%s",menu_color, 

screen_first_line); 

gotoxy (2,24); 

color_printf(“%s",screen_color,spaces) ; 

gotoxy (2,24); 

color_printf("%s",menu_color, 
screen_second line); 

gotoxy (column, row) ; 

menu_type +=23 

breaks 

case 333: /*Right Arrow*/ 
choice = choice + 2; 
case 331: /*Left Arrowb*/ 

--choice; 

if (choice < 1) 
choice = choices; 

if (choice > choices) 
choice = 1; 

start = 10 * (values[(choice-1)*4+2] - '0') 
+values[(choice-1)*4+3] - '0's 

length = 10 * (values[(choice-1}*4+4] - '0') 
+values[(choice-1)*4+5] - '0's 

gotoxy(2,24); 

for (indx = O;indx < menu_second_line_length; 
indx++) 

{ 


if ((indx >= start) && (indx < start 
+ length)) 
putcolorchar 
(menu_second_line 
(indx], 
highlight_color); 


putcolorchar 
(menu_second_line 
[indx], 
menu_color) ; 


gotoxy(column, row) ; 
break; 
default: 
if ((key_id >= 0x41) 8& (key_id <= 0x7A)) 
{ 


temp = toupper(key_id); 
for (indx=0; indx<=choices; indx++) 


{ 


start = 10 * (values[ 
(indx-1)*4+2] - 
'O')+values [(indx 
-1)#4+3) - '0'; 

if (temp == menu_second_line 


(start])) 
{ 


choice = indx; 
if (choice > 
select_no) 
goto ExitPoint; 

change_line_color 
(47); 

gotoxy (2,23); 
color_printf("%s", 
screen_color,spaces) ; 
gotoxy (2,23); 
color_printf("%s", 
menu_color, 
screen_first_line) ; 
gotoxy(2,24); 
color_printf("%s", 
screen_color,spaces) ; 
gotoxy (2,24); 
color_printf("%s", 
menu_color, 
screen_second_line); 
gotoxy (column, row) ; 
menu_type += 2; 
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may be generated dynamically or it may 
be generated manually by determining 
what bits need to be set and where they 
are located in the array. Since this latter 
process can be rather cumbersome, a 
utility function, set_cursor, has been 
provided to do the job automatically. 
You temporarily insert set_cursor into 
your program, just after the display has 
been generated. You can now move the 
cursor around the display and insert an 
x or X at every position where the cur- 
sor is to be allowed. You should also 
replace any x or Xs that occur naturally 
in the display in locations prohibited to 
the cursor with some other character. 
Make sure not to hit the Enter key until 
you have inserted all of the required xs 
in the display. 

When you hit Enter the program 
reads the entire screen and generates a 
file called MATRIX.C, which contains all 
of the ASCII data needed for initializ- 
ing a cursor map array in your program. 
You can set up the bit map array by in- 
serting the following line in your pro- 
gram: 


char nnnnnnnn[25] [10] = 


where nnnnnnnn is the name of your bit 
map. If you are using the Turbo C total 
environment editor, place the cursor 
after the equals sign and type “KR. 
When asked for the file name, type in 
MATRIX.C. The required data for the bit 
map will then be inserted into your pro- 
gram. You can then remove set_cursor 
from your listing and recompile the pro- 
gram. When you run the menu function, 
you will find that the cursor will only go 
to those positions which you marked 
with an x or X when you used set_cur- 
sor to construct the bit map. 


Key Designations 


Normal keys on the IBM PC key- 
board generate the standard ASCII rep- 
resentation of the selected letter or 
number. Most special keys, such as the 
cursor arrow keys and the F1 through 
F10 function keys return two characters, 
first a hex 0 and then some number 
from 1 to 255. To put all key returns 
into a common format, the menu pro- 
gram automatically reads a second char- 
acter from the keyboard when the first 
character is 0 and adds 256 to this 
second character to obtain a unique 
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if (key_id == escape_char) 
goto ExitPoint; 
switch(key_id) 
{ 
case 8: /*Backspace*/ 
case 331: /*Left Arrow*/ 
if ((menu_type == 0) [J 
(menu_type == 2)) 
change_line_color 
(screen_color); 
do 
{ 
column--3 
{f (column < 0) 
{ 


column = 79; 
TOW --3 
if (row < 0) 
row = 24; 


indx = column/8; 
remainder = column ~ indx*8; 
interim = map[row] [indx] & 
(0x01 << remainder) ; 

) 

while (interim == 0x00); 

gotoxy (column, row) ; 

if ((menu_type == 0) |] 

(menu_type == 2)) 
change_line_color 
(highlight color); 


“Are you taking advantage of the tremendous 
power and flexibility of C++?” 


Unleash the Power of C++ 
The powerful array handling capabilities 
+t 7 § that have accelerated development in advanced 
LIBRA scentific languages for years are now available in 
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EISPACK. Optional M++ modules further extend C++ into advanced object-oriented 
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break; 
case 333: /*Right Arrow*/ 

if ((menu_type == 0) || 

(menu_type == 2)) 
change_line_color 
(screen_color); 

do 

( 


columnt+; 
if (column > 79) 
{ 


column = 0; 
row ++3 
if (row > 24) 
row = 03 
} 
indx = column/8; 
remainder = column - indx*8; 
interim © map[row] [indx] & 
(Ox01 << remainder); 
} 
while (interim == 0x00); 
gotoxy(column,row); 
if ((menu_type == 0) || 
(menu_type == 2)) 
change_line_color 
(highlight_color); 
break; 
case 13: 
column = 0; 
case 336: /*Down Arrow*/ 
if ((menu_type == 0) || 
(menu_type == 2)) 
change_line_color 
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VALIDATION SUITES 
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number that will not duplicate one of 
the normal ASCII codes. This key input 
is stored in a variable called key _id. 
Thus, when looking at the program list- 
ing, some of the comparisons of key id 
with various numbers may appear un- 
familiar. They can be identified by 
taking any chart of keyboard codes and 
adding 256 to the second character 
generated by a particular key. The 
menu program has the flexibility of 
specifying which key will be used to es- 
cape from the screen type of operation. 
This capability will be described in fur- 
thur detail below. You should note, 
however, that whatever character you 
select for escape cannot be entered as 
data on the screen. 


Menu Options 


The programmer has almost un- 
limited flexibility in defining how the 
menu program is to be used. The menu 
options are selected by parameters 
passed through the menu function. 

The first parameter passed to the 
menu function is a string called values 
which defines the characteristics of the 
menu line. It begins with two digits 
which define the number of menu func- 
tion items. Four digits then follow for 
each menu item. The first two represent 
the column of the display at which that 
menu item begins. The next two repre- 
sent the number of characters in the 
menu item. These four digit entries 
must correspond to the actual spacing 
of the entries in the menu line string 
described below. 

The next parameter, called 
menu_first_line, is a string showing 
the first line of instructions when the 
program is showing the menu type dis- 
play. Following that is a string called 
menu_second_ line, which is the second 
line of instructions for the menu type 
(the actual set of menu function items). 
Next are two strings called 
screen first _lLine and 
Screen_second_line, which are the first 
and second lines of instructions when 
the menu program switches to the 
second type of operation. 

The next parameter, called 
menu_type, selects the mode of opera- 
tion. There are four modes of opera- 
tion for the menu function, which are 
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(screen_color); 
Trowt+s 
1f (row > 24) 
row = 0; 
{ndx = column/a; 
remainder = column - indx * 8; 
interim = map{row] [indx] & (0x01 << 
remainder); 
if (interim I= 0x00) 
{ 


gotoxy(column, row) ; 
if ((menu_type == 0) || 
(menu_type == 2)) 
change _line_color 
(highlight_color); 
break; 


column = 0; 
do 
{ 
indx = column/8; 
remainder = column - indx*8; 
interim = map[row][indx] & 
(Ox01 << remainder); 
if (interim != 0x00) 
{ 
gotoxy(column, row) ; 
if ((menu_type == 0) 
|| (menu_type == 2)) 
change_line_color 
(highlight_color); 
break; 
} 
column++; 
if (column > 79) 
{ 


column = 0; 

Tow ++5 

if (row > 24) 
row = 0; 


} 


} 
while (interim == 0x00); 
break; 


case 328: /*Up Arrow*/ 


if ((menu_type == 0) || 

(menu_type == 2)) 
change_line_color 
(screen_color); 

row--5 

if (row < 0) 
row = 24; 

indx = column/83 

remainder = column - indx * 8; 

interim = map(row] [indx] & (0x01 

<< remainder); 

if (interim I= 0x00) 

{ 


gotoxy(column, row); 
if ((menu_type == 0) || 
(menu_type == 2)) 
change_line_color 
(highlight_color); 
break; 
} 
column = 793; 
do 
{ 
indx = column/8; 
remainder = column - indx*8; 
interim = map[row] [indx] & 
(0x01 << remainder); 


if (interim != 0x00) 
( 


gotoxy (column, row) ; 
if ((menu_type == 0) 
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{| (menu_type == 2)) 
change_ line_color 
(highlight _color); 
break; 
} 
column--3 
if (column < 0) 
{ 


column = 793 


Tow --3 
if (row < 0) 
row = 243 
} 
} 
while (interim == 0x00); 


break; 
default: 
if ((menu_type == 1) || 
(menu_type == 3)) 
{ 


putcolorchar(key_id, 
screen_color); 
do 
{ 
column++; 
if (column > 79) 
{ 
column = 0; 
row ++; 
if (row > 24) 
row = 
0; 
} 
indx = column/8; 
remainder = column - 
indx * 8; 
interim = map[row] 
[indx] & (0x01 
<< remainder); 


while (interim == 0x00); 
gotoxy (column, row) ; 


} 


ExitPoint: 
return choice; 


} 
/* 


change _line_color = changes the color of a line up to a double space 


tf 
void change_line_color(int color) 


union REGS rin; 
char prev_char; 


prev_char = 's'; 
for(; 3 ) 
{ 


rin.h.ah = 3; 

rin.h.bh = 0; 

int86(0x10,&rin,&rin); 

ch = read_char_from 1 screen(); 

if((ch ==" ') 8& (prev_ char == ' ')) 
break; 

prev_char = ch; 

gotoxy(rin.h.dl,rin.h.dh); 

putcolorchar(ch,color); 


gotoxy(column, row) ; 


} 
/* 


clearscreen = clears the screen and displays selected color background 
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controlled by this parameter. They are 
assigned by one of the numbers zero to 
three. The modes of operation are: 

O = When the menu program is 
called, it will start with the menu dis- 
play. When it is in the screen display 
type of operation, all alphanumerics will 
be ignored. 

1 = When the menu program is 
called, it will start with the menu dis- 
play. When it is in the screen display 
type of operation, all alphanumerics will 
be displayed where typed. 

2 = When the menu program is 
called, it will start with the screen dis- 
play. When it is in the screen display 
type of operation, all alphanumerics will 
be ignored. 

3 = When the menu program is 
called, it will start with the screen dis- 
play. When it is in the screen display 
type of operation, all alphanumerics will 
be displayed where typed. 

The next parameter, screen_color, 
is the screen color. This has no effect 
upon the display that has already been 
generated, but does determine what 
color combination will be used for al- 
phanumerics typed on the screen and to 
restore the background for that part of 
the two instruction lines that is not 
used. Normally it should be the same 
color combination used in generating 
the original display screen. Table 1 
shows the color combinations repre- 
sented by each number. The next 
parameter, called menu_color, is the 
color combination used by the two lines 
of instructions produced by the menu. 
The next parameter, called high- 
light_color, is the color combination 
used to highlight the selected menu 
item. 

The next parameter determines how 
many menu functions will switch to the 
screen type of operation when selected. 
Those functions which switch to the 
screen type of operation must be 
grouped at the beginning of the menu 
line, since the count in this variable 
begins with the leftmost function. 

The next parameter, called es- 
cape_char, is the representation of the 
key which must be hit to escape from 
the screen type of operation. It is a 
number which is the ASCII value 
produced by a regular key or the value 
plus 256 if the keyboard output is a two 
character output beginning with 0. Thus 
any keyboard output may be selected. 
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*/ 
void clearscreen(int color) 


int indx; 
union REGS reg; 


gotoxy(0,0); 

reg.h.ah = 93 

reg.h.al = 

reg.h.bh & 

reg.h.b] = 

reg.XxX.cx = 
int86(0x10,4reg,&reg); 


/* 


color_printf = printf with selected foreground and background colors 


*/ 
void color_printf (char *msg,int color,...) 
union REGS reg; 
char ch, string[2000]; 
int i = 0; 
va_list (ap); 


va_start (ap,msg); 


vsprintf(string,msg,ap); /*do printf to 


va_end(ap); 
while ((ch=string[it+}) I= '\o') 
{ 
if (ch == Ox0A) 
{ 


reg.h.ah = 3; 
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{nt86 (0x 


reg-h.dl 
reg.h.dh 


reg.h.ah 
int86 (0x 


reg.h.ah 
reg.h.al 
reg.x.bx 
Teg .X.CX 
int86(Ox 


reg.h.ah 
int86(0x 


10,&reg,&reg); 

/*get cursor position*/ 

= 0; 

+45 

/*cursor value to beginning of next line*/ 
= 23 

10,8reg,&reg); 

/*set new cursor position*/ 


why 

10,&reg,&reg); 

/*send a color character to display*/ 
= 3; 

10,&reg,&reg) ; 

/*get cursor position in D reg*/ 


reg. x.dxtt; 
reg.h.ah = 2; 


/*increment cursor position value*/ 


int86(0x10,&reg,&reg); 


/* 
gotoxy = moves cursor to selecte 
“/ 


void gotoxy(int col, int row) 


union REGS reg; 

reg.h.ah = 2; 

reg.h.bh = 0; 

reg.x.dx = (row << 8) +c 

int86(0X10,&reg, &reg); 
} 


/* 
putcolorchar = 
and background 


*/ 


void putcolorchar(char character 
{ 
union REGS reg; 
reg.h.ah = 3; 
reg.h.bh = 0; 
int86(0x10,&reg,&reg) ; 
reg.h.ah = 9; 
reg.h.al = character; 
reg.h.bl © color; 
reg.x.cx = 1; 
int86(0x10,4reg,&reg); 
reg-h.ah =2; 
reg.h.d] = reg.h.dl+l; 
{nt86(0x10,&reg,&reg) ; 
} 


/* 


/*set cursor to new position*/ 


d column and row 


ol; 


displays a character with selected color foreground 


» int color) 


read char_from_screen » reads a character from the screen into 'ch' 


*/ 
char read_char_from_screen() 


char ch; 
union REGS reg; 


reg.h.ah = 3; 
reg.h.bh = 0; 
int86(0x10,&reg,&reg); 
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When this key is hit, it will immediately 
cause an exit from the screen mode of 
operation. The next parameter, called 
first_Line_loc, determines the line on 
which the first of the two menu lines 
begins. It may be any screen line from 0 
to 23. Normally the menu lines should 
be either at the top or bottom of the 
screen. 

The final parameter is the address of 
the bit map, which determines which 
are the permissible positions of the cur- 
sor. The bit map has already been 
described above. 


Supporting Functions 


The menu function uses several sup- 
porting functions. These include 
clearscreen, which clears the screen by 
filling it with spaces of a designated 
color; gotoxy, which positions the cur- 
sor at a desired column and row; put- 
colorchar, which displays a character at 
the cursor location with a specified 
color combination and moves the cursor 
to the next column; color printf, 
which acts like the standard C printf 
function except that it displays its data 
with a selected color combination; and 
change_line_color, which changes the 
color of a line of characters from the 
current cursor position up until a 
double space is encountered. Listings of 
these functions are shown for complete- 
ness. Many of them may already be 
available in standard libraries, but they 
are not included with the current ver- 
sion of Turbo C. If you are adapting the 
menu function for a monochrome dis- 
play, standard monochrome equivalent 
functions may be used in place of some 
of these functions. 


Conclusions 


The menu function provides a great 
deal of flexibility in manipulating data 
and making menu selections. About the 
only restriction is that all menu function 
item names must fit on one line. Colors, 
instructions, titles, order of mode, cur- 
sor settings, and whether or not al- 
phanumerics are to be displayed are all 
under the control of the programmer 
through the manner in which he calls 
the menu function. 0 


April 1992 
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reg.h.ah = 8: 


int86(0x10,&reg,&reg) ; 
ch = reg.h.al; 

attr = reg.h.ah3 
reg.h.ah =23 

regeh.d] = reg. h.di+l; 
int86(0x10,&reg,&reg); 


return ch; 
} 
/* 
set_cursor = sets up array of permissible cursor positions 
Si 


void set_cursor() 


int i,J,indx,remainder,key_value; 
char interim,map[25] [10]; 


FILE *fl; 
fl = fopen(“matrix.c","w"); 


for(i=031<=24; i++) 
for(j=0;j<=9; j++) 
map[i] [j] =0x00; 
} 
row=03 
column = 0; 


gotoxy(column,row) ; 
while ((key_value = getch()) != 13) 
{ 


if (key_value == 0) 
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value = getch()+128; 
More effective and casier to use diiedtiieeaa ue) aetsht) 
than standard class librarics. ~ 
Prevents spaghetti+ +. case 8: /*Backspace*/ 
case 203: /*Left Arrow*/ 
DATA STRUCTURE LIBRARY FOR C --column; 
Lets you code and debug three times faster break; 
with linked lists, a and hash tables, just case 205: /*Right Arrow*/ 
ay. Data pointers ++column; 
c. One command break; 
"It have fully-typed, case 208: /*Down Arrow*/ 
generic, persistc ‘alder 
: A reak; 
postibiebaly eee case 200: /*Up Arrow*/ 
--row; 


break; 
runs faster an default: 


templates, an putch(key value); 
libraries obsolete. I column++;_ 
relations. Auto neratcd classes 
prevent build- rchics. Associa- 
tions map dircctly into your code. 


DATABASE MAKER 
Creatcs instant m resident databases 
that run within + code, and are 
much faster th ive OODB sys- 
tems. Database sch cs general data column = 0; 
structures, and ot ed to a specific row--3 
language like fast disk l/O. } 
Schema migration is supported. if (row < 0) 
row = 0; 
gotoxy(column, row) ; 


} 
if (column > 79) 
{ 


column = 0; 
row+t+; 


if (column < 0) 


} 

row=0; 
* fast professional tool for commercial use column = 0; 
* improves maintenance and debugging while (row*columa < 1896) 
+ data integrity, no dangling pointers { 


+ highly efficient, ng -time overhead gotoxy(column,row); 


* easy to use, one di 
* automatic persiste 


* nocustom I/O funchid 


* portable data: C/ 

* memory managen 
allocators 

+ interactive data bi 

* works with debug 

* on-line help, exten 


* full source, self-tey 


* industry proven, t 
* UNIX (SUN, HP, 
Windows, Macintd 


ill get you started 
(binary/ASCI) 

s, structure blasting 
-, UNIX/DOS 

, external 


er 
and other tools 
» manuals 
B suite, examples 
years in use 
etc.), DOS, 
and most C/C+ + 


ch = read _char_from_screen(); 


if ((ch == 'x') |] (ch == 'X*)) 
{ 


} 


indx = column/8; 


remainder = column - indx * 8; 


interim = 0x01; 


interim = interim << remainder; 
map[row] [indx) = map[row] [indx] 


column++; 
if (column > 79) 


column = 0; 
Trow++; 


pee dibwory 7 
aphs, collections, 


tables, stacks, ER 
(time stamp, LISP- 


gotoxy(column,row); 


} 


clearscreen(30); 


| interim; 


er, and many other fpute('{', fi); 
gotoxy(0,0); 
full source, all ee) 


(j=03j<=9; j++) 


1.2/1.44 DOS disks oWSUN tar tape. Over- fprintf(f1,"Ox%x" ,map[i] (j]); 

seas add $25. Prices in US$, VISA, MC, PO, if (Ci t= 24) [| GJ f= 9)) 

or cheque. fputc(',',f1)5 
613-838-4829 fax: 838-3316 


$199 Full Source 


Code Farms Inc. 
7214 Joch Trail. Richmond, 
Ontario, KOA 2Z0, Canada 
613-838-4829 fan: H38-3316 


} 
fprintf(f1,"\n"); 


} 
fputc('}', fl); 
felose(f1); 


} 
/* End of File */ 
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FIRST IMPRESSIONS LAST. 


INSTALL 3.1 GIVES 
YOUR SOFTWARE 
PRODUCT A 
PROFESSIONAL 
INTRODUCTION. 


Installation procedures that rely on 
batch files and DOS commands not 
only look amateurish but also have 
limited error handling capabilities. 
Today’s users expect quality and 
ease of use from their software 
beginning the moment they open 
the package. A smooth, professional 
installation makes an important first 
impression. 


NEW FEATURES 


Over 50 new/enhanced keywords 
Now licensed once, like a compiler 
Supports products of unlimited size 
INSTALL.EXE is still tess than 80K 
Displays no copyright banner 
Supports Borland C++ 3.0 


Microsoft Windows Version 
coming soon! 


PROVEN 
RELIABILITY 


INSTALL 3.1 has been used for over 
four years by some of the biggest 
(and smallest!) names in the industry, 
in the U.S. and abroad, to install 
millions of copies of their programs. 
Add your name to that list today. 


INSTALL PRO 
* Builds Distribution Disk 
Sets Automatically 


* Full Screen Interface 


" Creates Script Files 
and DISK.ID Files 


High Performance 
Data Compression 


Slashes Work Time 
Up to 75% 


Splits & Compresses 
Files Of Any Size 


Can Tag A File, 
Or Directory Tree With 
One Keystroke 


Directory, 


Can Automatically Format 
360K, 720K, 1.2M, 
and 1.44M Disks 


Fully Compatible With 
Install 2.0 & Later 


KNOWLEDGE 
DYNAMICS 
CORPORATION 


P.O. Box 1558 
Canyon Lake, Texas 78130-1558 


CALL OR FAX BY 10 am 
(CST) AND RECEIVE 
INSTALL 3.1 TOMORROW 


+ Request 453 on Reader Service Card + 


EVERYTHING 
YOU NEED 


INSTALL 3.1 is customized for you: 
product with an ASCII text file called 
a ‘script file’. INSTALL 3.1 comes with 
many sample script files that you can 
modify and use immediately. No 
programming is necessary to create 
most installations. However, C source 
code  is_ included for your 
Sones and technical support 
is free. 


FAST AND SIMPLE 
Use INSTALL 3.1 to create an elegant 


installation procedure that will 
increase users’ confidence in your 
product. INSTALL 3.1 takes 


advantage of all available RAM for 
lightning-fast file transfers. All your 
documentation has to tell users is 
TYPE "A:INSTALL". 


30 DAY MONEY- 
BACK GUARANTEE 
Free technical support. No 


royalties. MasterCard/VISA/ 
COD/POs welcome. 


$399.95 INSTALL 3.1 PRO 
$249.95 INSTALL 3.1 Standard 
$ 99.95 International Option 
$ 99.95 OS/2 Option 


SALES 
1/800-331-2783X195 
International 1/512-964-3994 


24 hour FAX 1/512-964-3958 
24 hour BBS 1/512-964-3929 


Yet Another C++ 


Adolfo Di Mare 


I use C to program information systems that common- 
ly handle money quantities. Using doubles to represent 
money quantities can fail because the decimal digits are 
not represented correctly and round-off errors sometimes 
occur. A friend of mine, who uses Canon BASIC, has al- 
ways used floor (double*100.0) to represent money 
quantities. Any amount is represented as a double with 
no fractional part. This trick loses no decimals because it 


Page 58 — The C Users Journal! 


uses the double type, with its 15+ digit precision, as a 
compiler supported long long. 

For example, $25.35 is represented as the double 
2535.0, using a scale factor of 100 (for two decimal 
places). The problem I kept facing in my C programs was 
remembering when to multiply by 100 and when not to. 
For example, adding two doubles that represent money 
quantities doesn’t require you to multiply by 100 


$25.35 + $35.75 
-> 2535.0 + 3575.0 == 6110.0 
-> $61.10 


In addition, one should never multiply by the scale 
factor when multiplying a money quantity 


$100 * (1.0+0.06) 
-> 10000.0 * (1.06) == 10600.0 
~> $106 


It is very easy to forget to multiply by the scale 
factor when using doubles as money. When I 
started programming in C++, I realized that a C++ 
money class was the solution for these problems. 


Defining Requirements 


After examining Zortech’s C++ money class (see the 
sidebar on available tools), I sat down to define the re- 
quirements for my own money class. I came up with seven 
design goals: 
¢ Money quantities should behave as regular numbers. 
¢ The money class should be portable and not compiler 

vendor dependent. 
¢ The programmer should be protected from misusing 

money quantities. 

* It should be possible to use standard library functions 
with money quantities. 
° Most operators should be inline, to let the 

compiler optimize the generated code. 
e The money header file should be short. 
e¢ The programmer should be able 
to define the number of 
decimals in a money data item. 
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Money Class 


I ended up having to devote more storage space to the 
money variable than I originally wanted: eight bytes for most 
computers, compared to six (25 percent less) for the Zortech 
implementation. 

Listing 1 is the header file money.h, which defines and im- 
plements the money class. Ail the methods in this class are in- 
line, fulfilling my fifth requirement. The various arithmetic 
Operators cater to the diverse situations found in real-life 
programs. 

The money class permits a programmer to write expressions 
such as 


money mm,m 1000; // I've got a thou' 
double tax = 0.23; // State Government of Insomnia 
m *= (1-tax); // This is what I have 
m = m+500; // Thanks, Mom... 
mn = 500; 
m =m + 1500 - (mm / m) * (1.0/3.0); // etc... ‘ 
printf("Salary = %10.2f\n", 
(double) ((10+mm)/m * m)); 


In a nutshell, the programmer can freely mix money quantities 
with regular numbers to obtain the correct results. Further- 
more, the compiler will warn the programmer if he or she tries 
to misuse money data items, as in 


money m, mm; // ok 
double d = m*mm; // can't multiply moneys 
mm = d/m; // can't divide by money 


Listing 2 is a test program for the money class. A symbolic 
debugger will illuminate the goings-on at each point in the 
program. 


Adolfo DiMare preaches and does research in 
programming at the Universidad de Costa Rica. 
When he is not busy reading The C Users Jour- 
nal, he can be reached at (506) 24-0504 or as 
adimare@OCRVM2 through BITNET. 
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Listing 1 (money.h) 


/* @{0) moncy.h Copymiddte 1991 Adolfo Of Mare */ 


thal a] 
i Yet Another Money Cet Class bd 
ye */ 


/* Use freely but acknowledge author and publication, */ 
/* OO NOT SELL IT. The author reserves all rigths! *] 


i BITNET: adimare@UCRYM2 */ 
/* Compiler: Borland C++ v 2.0 */ 
/* [should work with Turbo C++] */ 


fifndef _money h 
édefine _woney h 


extern "C* { // avoid type clashes with the C library 
@include <math.h> = /* floor() */ 
@include <float.h> /* DBL_DIG */ 

i 

@ifndef MONEY DECIMALS /* number of decimals in */ 


#define MONEY_DECIMALS 2 /* any maney quantity */ 
dendif /* don't use parentesis! */ 


fdefine VAL(n) /* 1 level indirection */ 
define TENPOW(n) _ VAL(1.0c##n) /* Trick to yleld 10*n */ 


@define MONEY DIG DBL_DIG 


class money { 
public: 


static int decimals() { return MONEY DECIMALS; } 
static int digits()  { return MONEY OIG; } 
static double SCALE() 

{ return TENPOW({MONEY DECIMALS); } 


money(); // do nothing constructor 
money (double); // constructor from double 
money(const money&); // copy constructor 


money& operators (const money&); // copy operator 
money& operator= (double); // copy from double 
operator double{) const; // convert to double 


int OK() const; // check money's invartant 
void FIX(); // get rid of unwanted decimals 


friend money operator + (const money&, const money’); 
friend money operator + (double, const money&); 
friend money operator + (const money&, double); 
friend money operator - (const money&, const maney&); 
friend money operator - (double, const money&); 
friend money operator - {const money&, double); 


friend money operator* (const money&, double); 
friend money operator* (double, const money’); 
friend double operator/ (const money&, const money&); 
friend money operator/ (const money&, double); 
friend money operator’ (const money&, const moneys); 


// woney * money 1s NOT valid 
// double / money is INVALID 


friend int operator == (const money&, const money’); 
friend {nt operator l= (const money, const moneys); 
friend int operator < (const money&, const money); 
friend int operator > (const money&, const moneys); 
friend int operator <= (const money&, const money&); 
friend int operator >= (const money&, const money); 


money& operator += (const money’); 
money& operator += (double); 
money& operator -= (const money&); 
money& operator -= (double); 


money& operator *= (double); 
woney& operator /= (double); 


friend money operator+ (const money’); 
friend money operator- (const money’); 
money& operator++(); 
money& operator—(); 
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friend int operator! (const moneys); 


friend money abs(const moneys); 
friend money flatten{ 
const money& m, 
double cents*0.25, int rounding = 1 /* TRUE */); 


protected: // let users change the class behaviour 
double m_money; 
hs 


// Constructors && assignment 
inline money::money() { 
// do nothing constructor, for efficiency 


inline money::money(double d) { 
// construct from double 
m_maney = d*SCALE(); 
FIX(): 


1 
inline money: :money(const money& m) { 
// copy constructor 

m_money = m.m_money; 


inline money& money::operator= {const money& m) { 
// copy operator 
m_money = m.m_maney; 
return *this; 
) 
inline maney& money::operator= (double d) { 
// assign from double 
m_money = d*SCALE(); 
FIX(); 
return *this; 


inline money::operatar double() const { 
// convert to double 

return mmoney / SCALE(); 
} 


inline int money::0X() const { 

// Returns TRUE (1) when the quantity stored 
// in *this really corresponds to a money 
// quantity, 


money temp; 
temp.m_money = m_money; 
temp.FIX(); 
return ( 
( temp.m_money == m_money ) 
ab 
( fabs{m_money) < (TENPOW(DBL_DIG) / SCALE()) ) 


inline void money::FIX() { 
// Deletes all decimals digits beyond 
// the MONEY DECIMALS decimal place. 
// - If the value is aut of range, FIX 
// won't fix it. 

m_money = 

(m_money > 0.0 
7 


floor( 
m_money 
#ifdef MONEY ROUNDING 
+ 0.5 // 0.49 1s also an option... 


fendif 
cefl( 
m_money 
@ifdef MONEY ROUNDING 
- 0.5 
fendif 
) 
s 
} 
/] add 


inline money operator (const money& m, const money& mm) { 
money temp; // don't mult*SCALE() 
temp.m_money = m.m_money + mm.m_money; 
return temp; 
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Implementation Details 


I first tried to fake money quantities 
using Longs, but the difficulty in doing 
so stopped me from pursuing this ap- 
proach. (The Zortech tool’s money type 
is implemented using integer arith- 
metic.) 

After I realized that the money vari- 
able would be a double, the main im- 
plementation problem was to keep track 
of when to multiply by the scale factor 
and when not to. This I accomplished in 
each of the overloaded arithmetic 
operators. 

I also implemented the 
money::FIX() member functions to get 
rid of the excess decimals whenever ap- 
propriate. When the preprocesssor con- 
stant MONEY ROUNDING is defined, the ex- 
cess decimals in a double assigned to a 
money variable are rounded. Otherwise 
the excess decimals are truncated 
money m(1.5199);  // $1.52, when 
// MONEY_ROUNDING 


money m(1.5199); | // $1.51, when 
// not MONEY ROUNDING 


The programmer cannot selectively 
choose whether to round or not case by 
case because the decision is made at 
compile time. 

The preprocessor constant 
MONEY DECIMALS defines how many 
decimals a money item has. The mem- 
ber function money::SCALE() is imple- 
mented using a preprocessor trick that 
returns the scale factor used to multiply 
a double to make it a money quantity. If 
three decimals are needed for money 
items, the scale factor would be 1,000 = 
10°. In some countries the inflation is so 
high that the number of decimals is 
negative. In this case the scale factor 
would be a number less than one. Since 
money::SCALE() is an inline function, 
the compiler can optimize out the 
division by the scale factor in some 
cases. If the programmer doesn’t define 
MONEY DECIMALS, then the class uses a 
default value of two decimals. In my 
programs, I define MONEY DECIMALS 
before including the money. h file 
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#define MONEY DECIMALS 4 // must 
// use a decimal number 
#include "money.h" // or TENPOW 
// bombs. 


The vector constructor 
money::money() does not initialize a 
money item, because in many cases 
doing so would be wasteful. The 
programmer can consider money items 
as regular numbers. The compiler 
should be able to optimize out this con- 
structor if it is used. 

Though the class money implements 
most arithmethic operators, it does not 
implement the following 


money operator* (const money&, 
const money&), 

money operator/ (const double, 
const money&); 


It just does not make sense to use these 
operators in a program. If you use 
them, you will get a compile time error 
(a dissatisfied programmer could add 
them to the class easily). 

As arithmetic operators in money.h 
demonstrate, the class is programmed to 
minimize the number of times that each 
double must be scaled up by the scale 
factor. 

The comparison operators are 
defined only for money items. Thus 
when a money data type is compared to 
a double, the compiler promotes the 
double to a money variable using the 
constructor money: :money(double). To 
prevent the promotion, the programmer 
should use an explicit typecast 


double d = 15.253; 
money m = 15.25; 


// 15.253 
// $ 15.25 


if (d == m) { // TRUE: d 
// becomes money (d) 


} 

if (d == (double) m) { // FALSE: 
// 15.253 != 15.25 

} 


The function flatten(money, cents, 
rounding) rounds up a money quantity 
to the nearest value that can be paid in 
coins. For example, Costa Rica has no 
one cent coin because the smallest coin, 


The “Standard” Foundation C++ Class Library 


NOW HAS TEMPLATES! 


Tools.h++ 

At Rogue Wave we are committed to allowiny, cur ice te tap all 

of the puwer that C+ ¢ offers. For today’s compilers, that nicana 

templates. Tals he +, our best «alling industry standard C++ 

library, now includes Templates! Tuols.hes isa complete toalbos 

of over 60 C++ classes. It ia.a ot of efficient and veratle C44 

foundation classes that will make virtually any programming jb 

easier. 

¢ Time and Date handling and manipulation (Liaw. 

¢ String and Character manipulation classes. 

© Singly and Doubly linked lists, Stacks, Queucs and Vecters: 
classes. 

© Smalltalk™-like Collectlon classes: Set, Bay, SortedCollection, 
OrderedCollecttun, Dictionary, Stack, Queue, utc. 

© Regular Expression Class for search and replace. 

* Tokenizer Class for easy string parsing. 

® File Class ta handle file manipulation with read, write, seek, 
erase, etc. 

© Btree Class fo handle efficent keyed accuss of disk records, 

File Space Manager Class to allocate, deallocale and coalesce 
space within files. 

® Utility to detect memory leaks, reuse after deletion and wild 
pointers. 

« Virtual and Buffered Page Heap to manage objects tigger than 
64k. 

© Other classes include: Bit vectors, Virtual 1/O streams, Cache 
managers, Error handling and many more! 


Rogue Wave's Toals.h++ is an “industrial strength” library. All 
classes have not been derived from a single root cbject. su they can 
be easily integrated with other class libraries. All classes have a 
Persistent Store facility that allows complex objects to be stored and 
retrieved on heterogeneous nelworks or the Windows 3.0's 
Dynamic Data Exchange or clipboard facility. The classes art 
bulletproof, optimized for speed, ard well tested. Tools.h++ 5 a | 
excellent example of how to write true C++ code correctly. Suurc 
Code is included. 


Full Source Code! 


Compatible with * Complete manual full of 
MS-DOS, UNIX, C++ hints and tips 
Windows 3.x, OS/2 ¢ Numerous examples 


and other OS's. * No Royalties 


* Compiles with Borland 
C++", Zortech*, Oregon’, 
Liant®, Microsoft C++" & 
most other C++ compilers 


e 

Linpack.h++ 

The full power of the widely 
used Fortran LINPACK 
routines plus much more, completely recoded in a True object- 
oriented C++ interface ¢ Fully optimized with assembly language 
BLA routines: includes assembly language BLA‘s for §0X8 & 
60X87 processors * Indudes Mithh++, the fastest C++ Math library 
available. * Complete vector and matrix classes - complex, double, 
int, char, float, etc. ¢ Statistics—Random number generators 
(Gaussian, Poisson, ete.); histograms; probability functions; Linear 
regressions, etc. © Linear Algebra—matrix inversions; LU 
decomposition; solutions of linear equations; determinants ¢ Signal 
Processing—Fast Fourier Transforms: comples; real; 1- and 2-D ¢ 
Slice and pick operations; SubMatrices. 


cau now: 1-800-487-3217 


ROGUE WAVE 
SOFTWARE 


P.O, Box 2328 © Corvallis, OR 97339 
503-754-3010 © FAX 503-757-6650 
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Listing 1 — Cont'd 


inline money operator+ (double d, const money& m) [ inline money& money::operator -= (const money& m) { 
return (money(d) +m); m_money -= m.m_money; 
return *this; 
inline money operator+ (const money&S m, double d) { } 
return (mtmoney(d)): inline money& money::operator -= (double d) { 
m money -© d*SCALE(); 
FIX(); 
7/7 substract return *this; 
inline money operator- (const money& m, const money& mm) [( 
money temp; inline money& money::operator *= (double d) { 
temp.m_money = m.m_money ~ mm.m_ money; m_money *= d; 
return temp; FIX()3 
return *this; 
inline money operator- (double d, const money& m) [ 
return (money(d)-m); inline money& money::operator /= (double d) { 
} m money /= d; 
inline money operator- (const money& m, double d) { FIX(); 
return (m-money(d)); return *this; 


} } 


// multiply // unary op's 
inline money operator* (const money& m, double d) { inline money operator+(const money& m) { 
money temp; return m; 
temp.m_money = m.m_money * d; // don't mult by SCALE() } 
temp.FIX(); // this could be delayed... inline money operator-(const maney& m) { 
return temp; money temp; 
} temp.m_maney = -m.m_money; 
inline money operator* (double d, const money& m) [ return temp; 
return (m*d); 
inline money& money: :operator++() { 
m_money += SCALE(); 
// divide #if (MONEY_DECIMALS<0) 
inline double operator/ (const money& m, const money& mm) { FIX(); // avoid problems because of 
return m.m_money / mm.m_money; fendif // the representation of 10*-n 
return “this; 
inline money operator/ (const money& m, double d) { } 
money temp; inline money& money::operator—() { 
temp.m_money * m.m_money / d; m_money -= SCALE(); 
temp.FIX(); // this could be delayed... #if (MONEY_DECIMALS<0) 
return temp; FIX(); 
} fendif 
inline money operator’ (const money& m, const money& mm) { return *this; 
money temp; 
temp.m_money = fmod(m.m_money, mm.m_money) ; inline int operator!i(const money& m) { 
temp. FIX()s // this could be delayed... return m.m_money == 0.0; 
return temp; } 


} 
inline money abs(const money& m) { 
// compare money temp; 
inline int operator {const money& m, const money& mm) { temp.m_money = fabs(m.m_money); 
return m.m_money im.m_money; return temp; 
} } 
inline int operator (const money& m, const money& mm) { 
return m.m_money m.m_money; money flatten(const money& m, double cents, int rounding) [ 
// Returns a money data item where the cents are 
inline int operator (const money& m, money& mm) { // rounded modulo “cents". In this way cents can 
return m.m_money mm.m_money; // be stripped of money items when the currency 
} // does not have all the coins required to pay 
inline int operator (const money& m, money& mm) { // every posible quantity. 
return m.m money fmm. m_money; money temp; 
} double c = floor(fabs(cents*money::SCALE())); // cents 
inline int operator (const money& m, money& mm) { double r = fmod(m.m_money, c); // remainder 
return m.m_money am.m_money; temp.m_money = 
(lrounding |] (2.0* r <= c) 
inline int operator >= (const moneyh m, money& mm) { ? mm_money - r 
return m.m_money >= mm.m_money; : mam_money - r + ¢ 
); 
return temp; 
inline money& money::operator += (const money& m) { } 
m_money +« m.m_money; 
return *this; /* Avoid name space overcrowding */ 
) undef VAL 
inline money& money::operator += (double d) { fundef TENPOW /* jic: Just In Case! */ 
m_money += d*SCALE(); 
FIX(); fendif /* money _h */ 
return ‘this; 
/* End of File */ 
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called a pesefa, is worth 25 cents of a col6n. In the following 
example the money item m is rounded up to pesetas 


money m = 125.80; // 125.88 colones 
money mm = flatten(m); // 125.75 colones 


The header file called money.h implements the complete 
money class using inline functions, which permit the compiler 
to optimize out any floating point operations it can. I decided 
not to provide more operators for money items, because the 
type converter money::operator double() allows the stand- 
ard math functions to work with money items. money.h in- 
cludes only two files, math.h and float.h, which contain the 
prototypes for the functions floor (), ceil(), fmod(), and the 
constant DBL_DIG. In order to use bigger money quantities, you 
can declare every double variable in money.h as a long 
double. 

As implemented, the money class should be quite portable 
because it does not make use of any odd C++ constructs. 
Depending on the compiler used, it is quite possible to op- 
timize out many of the inline operators, and thus yield effi- 
cient programs. 


Conclusion 


This tiny C++ money class lets the programmer use money 
items with ease. The implementation is as efficient as using 
floating point values in arithmetic expressions. This should be 
reason enough to use it right away. 0 


CHOICE INSTALL 


Easy to use, Efficient Installation program with: 
All of the most needed features and more. 
Automatic detection of system features. 

Runs under DOS, Windows, or OS/2 comp. box. 
No script language to learn. 

Fast file transfers using all available RAM. 

Uses Microsoft, Borland, Zortech C, C++. 
Takes less than 100K on your distribution disk. 


No programming! Run the generator, "fill in the 
blanks", compile and link, run the build program to 
create your disks and you're ready to ship! 


90 day money back guarantee, no royalties or 
extra licenses for multiple products. Send $149, FAX 
or call (602)298-0666 with Visa or M/C. Fully 
functional demo disk: $5, credited on purchase. 
Specify disk size (3.5" or 5.25" HD). 


ChoiceWare 
8802 East Broadway Suite 211, Tucson, AZ 85710 


Microsoft, Borland, Zortech are trademarks af their respective companies. 
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Listing 2 (money.c) 


1991 Adolfo Di Mare 
ad{mare@UCRYK2 


/* Q(@) money.c 
/* 


Test driver for money.h 


Borland C++ v 2.0 


Compiler: 
(should work with Turbo C++] 


To see what 1s going on, you need to use your symbolic 
debugger to examine each of the declared variables. 


For Borland C++, I used the following watches: 
m_money d,fls 
mr i 
m,r 1 
elapsed s,fl8 


Change the compfle time macros to see how money's 
change their behaviour. 


“/ 

fdefine TEST 

fifdef TEST /* ( */ 
aif o 


fdefine HONEY ROUNDING 
fendif 


/* Force rounding of doubles */ 


fdefine MONEY DECIMALS 2 /* 2 decimals for money data */ 


extern "C++" { 
finclude "money.h" 


a 


Ne 


Extends BRIEF & PVCS (Sage) to include 
a Multi-language Source Browser! 


@ Languages Supported: Microsoft C 6.0, MASM 6.0, 
BASIC 7.1, COBOL 4.0, FORTRAN 5.1 & later versions. 
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Listing 2 — Cont’d 


@ifdef —_ TURBOC__ 
finclude <{ostream.h> 
telse 
finclude <stream.h> 
fendif 

) 


inline ostream’ operator<<(ostream Sout, moneyh m) ( 
return out << (double) m; 
} 


extern "C> { 
finclude <stdlib.h> 
finclude <time.h> 
@include <stdio.h> 
} 


tdefine RANGER 
fundef RANGER 


/* takes forever to run... */ 
void ranger(void); 
int main(void) ( 

7/ To the right is the assigned value 


money m(25.8499); // $ 25.84 
money mi; // $ #$$480$8.98 


int i= 53 i 5 
long 1= 6; // 7? 
double d=m; 4 25.8399999999999999999999999999 


mm; /i 25 
qd; /1$ 25.84 
7 


-009999999; // $ 7.00 
mt= 1; /1$ 8.00 
m += 1.245000001; // $ 9.24 
mt IL; //$ 10.24 
m= ‘ats //$  'a'+10.24 


m = -d; /1 $ -25.84 
m = -7.00999999; // $ - 7.00 
m-" 1; // $ - 8.00 
m -= 1.245000001; // $ - 9.24 
m-" IL; // $ -10.24 
m-= ‘ats // $ -'a'-10.24 


m= 10; /1$ 10.00 
m = m4; //$ 14.00 
© mm+4.014999; // $ 14.01 
= 4.99+mn: /1$ 14.99 
= Atm; 14.00 
= min; 24.00 
+2 ms 48.00 


// $10 == OL * $77 + ($10) 


m= 773 /1$ 77.00 
mm = 10; // $ 10.00 

m=m% om 4/$ = 7.00 

//1$77 == 7L * $10 + ($7) 


mets /1$ 8.00 
mm; /1$ > 7.00 


= 11.75; 
+= 0.125 
flatten(m,0.25,1); 


0.01; 
flatten(m,0.25,1); 


flatten(m,0.25,0); 


0.01; 
mm = flatten(m,0.25,0); 


m -= 55 

m +2 0.12; 

if (m == 0 Jj] O == m) { 
mo ds 


} 
else if (1(m == m)) { 
m= 1; 


else {f (m>m) { 
m=m 
} 


else if (m<m) { 
mem 


else if (m l= m) { Jin 
m= nm; 
? 
else if (m >= m) { /ly 
11% 77.00 
/1$ 92.00 


// 92 

11 $ -92.00 
/1$ 8,464.0 
/1 $ -92.00 


// 15.253 
‘7/7 $ 35.25 


if (d == m) ( // TRUE: 
1 = 0; “71 = OL 


11.75 
11.87 
11.75 


11. 
12. 


ll. 
i. 
Nl. 


1). 
ll. 


ep 


ep 


d becomes money (d) 


rT 
= mtd; 14.00 if (d == (double) m) { // FALSE: 15.253 t= 15.25 


= mat4.011; 
= 4.99+m; 
= 44m; 


aeaaa 


= 10; 

= mmt4; 

= mm*4.0; 
= Atm; 

= 4.0°m; 


= 10; 

® 7.00001; 
= d*matd; 

= (d*ma)+d; 
= d+d*ma; 

= d+(d°mm); 


14.0099999999999998 
14.9900000000000002 
14.00 


10.00 
40,00 
40.00 
40.00 
40.00 


10.00 
7.00000999999999962 

77,00 

77.00 

77.00 

77.00 


10.00 
77.00 
10.00 
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++; 4/1 == 0 


// simulate a TAX -calculation 
m= 0.03 
for (i = 13 i <= 100; i++) ( 
d = i*1.005; // 0.05% ta 
m+ ds 
} // $ 5,075. 
mm = 100; //$ = 100. 
(double) mn; 4/$ ~~ 50. 
3; /1$ 16. 
3; ‘1$ ~~ 50. 


mm = mm/mmn; - // Ti 
d =m* (m/mm); // = 2573. 


d = 1.0/3.0 * m; ‘/ 16. 
mm = 1.0/3.0 * m; 11 $3 16. 


L 


x 


00 
00 
75 
91 
73 


00 
5300000000002 


9100000000000001 
91 
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Available Tools 


My first move in creating a money 
class was to examine the available tools 
to handle money quantities. I looked at 
the following: 

Borland’s C++ 8CD class 

Zortech’s C++ BCD class 

Zortech’s C++ money class 

BCD stands for Binary Coded Decimal. 
The binary representation used in com- 
puters is a sequence of binary “digits” 
called bits. BCD, on the other hand, 
stores a number’s value in base 10 
digits, usually using their binary values. 
For instance, the number 1234 is stored 
in a pair of bytes using the same bit pat- 
tern as the 0x1234 hexadecimal con- 
stant. Since most computers use eight- 
bit bytes, each byte will hold two BCD 
digits. Many bit patterns are not valid 
when interpreted as BCD numbers: 
OxFFFF, OxOAQA, 0x123A, are all invalid 
BCD quantities because in decimal nota- 
tion we can use only the digits 0...9. 
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I chose not to use Borland’s BCD 
class because it does not provide 
specific support to handle money quan- 
tities. For example, whenever you multi- 
ply and divide two money variables, you 
must figure out what to do with the 
digits that go beyond the number of 
cents. The header file in Borland C++ 
v2.0 pulls in the tostream.h header file, 
which slows down compilation quite a 
bit. I still don’t use streams, and I don’t 
like to be forced to use them if I don’t 
have to. Also, much of the BCD library 
must be loaded when using 8CDs, in- 
creasing the size of executable files even 
more. Finally, Borland doesn’t include 
the source code for this class with the 
compiler, though it is available at extra 
charge. I have learned to examine a 
library’s source code before using it. 


Zortech’s BCD class shires most of these 
inconveniences. 

The Zortech C++ Tools package 
implements a money class, where 4 
money quantity is a two member struc- 
ture: 


class money 
{ long dollars; 
int cents; // ... }; 


In most implementations, a long can 
hold only nine or ten decimal digits. 
The range of numbers is limited com- 
pared to that granted by doubles. This 
class is efficient because the operators 
are implemented using integer arith- 
metic and each money variable is quite 
short. 0 
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Listing 2 — Cont’d 


(34 mm); /1 $1.00 mel; 
mn / (M_PI * pen); 11 $1.00 mm = pow(10, 6); 
// $3.14 now = clock(); 
for (1 = O03 1 <= 100001; 1++) { 
rae mm/ma 4+ 1 ~ (3 * rm / (3 * mm); // $1.00 mm = ms 
me= ME * wm / (mn * ME) - 1; 11 $0.00 m /* 0.99001; // Div 
if (Im.0K()) { 
// m=" 0.0 && om == $1.00 m.FIX(); // won't fix overflows 
for ({ = 1s 1 <= 1003 i++) { } 
mn /= 3; 47 $ ~~ 0.33 } 
m © mtn; // Add a third elapsed = (clock()-now) / CLK_TCK; 
m =; d = elapsed; // 8.46 secs 
} i) 33.00 
d =m%¥m+ 33: // 33.00 
d =m; / 33.00 m= d; /1 $ 33.00 
mm =m / 330; “ig 0.10 mn = d / 330; //$ 0.10 


clock _t now; d = (10+mm)/m * m; //- 10.089... 
double elapsed; 
// Must use (double) type cast 
// time statistics, on an 33MHz 386 printf ("Salary = %10.2f\n", 
m= 03 (double) ((10+mm)/m * m)); 
now = clock()3 cout <<"Salary = ° 
for (1 = 0; 1 <= 100001; 1++#) { << (double) ((10+mm)/m * m) << '\n'; 
m= 1.01; // Add $1.01 
} 


elapsed = (clock(}-now) / CLK TCK; // valid only if you define 
d = elapsed; /1 3.51 sees // ostream& operator<< (ostream&, money&) 
cout <<"Salary = " 
m=); << (10¢mm)/m * m << '\n': 
now = clock(); 
for (1 = 0s 1 <= 100001; I++) ( med/m; // should not compile... 
m ** 1.0001; // Mult mem * ms // won't compile: AMBIGUITY ERRORI!! 


} 

elapsed = (clock()-now) / CLK_TCK; fifdef RANGER 

d = elapsed; // 3.24 secs ranger(); 
fendif // RANGER 


exit(0); 
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Lexical Analysis Using Search Tries 


John W. M. Stevens 


Recently, there has been a lot of talk about 
an old UNIX idea, that of user program- 
mability. User programming presents some 
drawbacks, not least of which is the absence of 
a standard language. Each new program re- 
quires the user to learn a new language (unless 
the new program is a clone of another). Also, 
though different user languages may have 
similiar syntax, they may not interpret a state- 
ment the same way. In addition, user program- 
ming languages have, until just recently, been 
cryptic and difficult to learn. 


Language Interpreters 


To create a program that is user-program- 
mable requires that the software engineer 


John Stevens is a graduate of Colorado State University with a bachelor’s degree in computer 
science. He has worked at five different companies as a programmer and software engineer, 
writing everything from accounting programs for truck drivers to C compilers for high-speed 
parallel computers. He is currently working for Space Tech as a compiler writer. 


know how to design, write, and maintain a lan- 
guage interpreter. Such arts are taught in most 
computer science curriculums. A language in- 
terpretation system contains three basic com- 
ponents: the lexical analyzer, the parser, and 
the interpreter. 

The first part of the system, the lexical 
analyzer, takes ASCII input, separates it into 
words, and converts those words to numeric 
values, called tokens. Words that have special 
meaning in the language are called keywords. 
Punctuation characters, such as ; and :, also 
have special meaning in the language and must 
be tokenized as well. The lexical analyzer deter- 
mines if the input contains illegal words or 
punctuation characters. 
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While the lexical analyzer breaks the 
input text into words, it does not deter- 
mine whether the words are arranged 
into legal sentences. This is the job of 
the parser. The parser takes a stream of 
tokens from the lexical analyzer and at- 
tempts to determine if they form a 
stream of legal sentences according to 
the language’s grammar. A grammar 
consists of a set of rules that describe all 
legal sentences possible in the language. 
Not all legal sentences make sense. In 
most programming languages, the par- 
ser will accept legal sentences that the 
interpreter cannot understand or ex- 
Example Search Trie ecute. 

Once the parser has decided that the 
token stream forms legal sentences, the 
interpreter combines the operations of 
semantic analysis and program execu- 
tion. Semantic analysis determines what 
operations the program is telling the in- 
terpreter to execute. Execution is the 
operation of reading progam tokens and 
translating them into a series of 


Figure 1 
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machine language function calls that in- 
struct the CPU what to do. Interpreted 
languages execute slower than compiled 
languages, in part, because the inter- 
preter must translate each program sen- 
tence into machine language every time 
it is executed. Sentences from compiled 
programs are already translated into 
machine language. 


Lexical Analyzers And 
Search Tries 


To facilitate the construction of lexi- 
cal analyzers, I use a special class of 
search tree, called a tre. A trie is a tree 
data structure that allows strings with 
similiar character prefixes to use the 
same prefix data and store only the tails 
aS separate data. One character of the 
String is stored at each level of the tree, 
with the first character of the string 
stored at the root, and the last character 
of the string stored at a sub-tree node 
or in a leaf node. Figure 1 shows how a 
trie would store the following collection 
of words: ape, append, able, bee, bear- 
ing, cape, caper, capable, us, use and 
user. 

Tries used for fexical analysis store 
token values with each character in the 
trie, as shown in Listing 1. Most of the 
token values are zero, indicating IL- 
LEGAL KEYWORD. The token value of the 
last character of each legal word is the 
token value for that word. For example, 
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in Figure 1, the struct for the letter e 
in the trie branch under the letter u 
stores the token value for the word USE. 
The letters s and r in the same branch 
would have the tokens US and USER 
stored with them, respectively. 

Using a trie in a lexical analyzer 
combines the operations of breaking the 
input text into words and determining 
whether or not the words are legal for 
the language. This scheme imposes lan- 
guage design constraints on the en- 
gineer, since words do not have to be 
delimited to be recognized. The con- 
straint is either to design a requirement 
for delimitation into the language 
definition or to ensure that no two ad- 
jacent words of the language can ever 
be combined to make a longer, legal 
word of the language. 


Static Tries In C Arrays 


I prefer to store my tries as static 
data in the same file as the code for the 
lexical analyzer. This arrangement al- 
lows each program to use more than 
one lexical analyzer, as well as 
eliminates the need for external files. 
On the other hand, tries have a widely 
variable number of elements per trie 
level, making it imperative to use a 
dynamically-sized data structure. The 
method I adopted stores each level of 
the trie as a uniquely named array with 


Listing 2 


L_PAREN 
R_PAREN 
COMMA 
F_SLASH 
action ACTION 
after AFTER 
and AND 
archive ARCHIVE 
attributes ATTRIBUTES 
before BEFORE 
directory DIRECTORY T 
exec EXEC 
files FILES 


hidden HIDDEN 
label LABEL 
modified MODIFIED 


name 

not 

or 

print 

readonly READONLY 

recurs RECURS 

search SEARCH 

select SELECT 

system SYSTEM 
L_BRACE 
BAR 
R_BRACE 
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Figure 2 


Read a character from the file. 

Call step 2 with the pointer to the root of the trie, the 
character read and a pointer to the begining of the key word 
save buffer. 


Search for the input character in the current node of the trie. 
If the input character {s found in the trie then 
Save the input character in the key word save buffer. 
Attempt to read a character from the file. 
If End of File then 
Return End of File. 
If the character found has a child trie pointer then 
Call Step 2 with the child trie pointer, the character 
read from the file and a pointer to the next byte in the 
key word save buffer. 
If the return value from the call to step 2 {s NOT FOUND then 
Unread the character read from the file 
Return the token value stored with the input character 
of this call. 
else 
Return the return value of the recursive call. 
else If the character is not found then 
Save a NUL in the key word save buffer. 
Return the value NOT FOUND. 


Listing 1 


typedef struct key st { 


char Cc: 
TKNS token; 
struct key_st *child; 


/* String character. 
/* Token value. 
/* Pointer to sub-trie. 


} NODE; 


NODE Structure 


MEMORY PROBLEMS SOLVED! 


Kandu Tools Help You Break The 640K Barrier! 


Up to 352K More Memory! $1 49 
* Easy to use, one to one malloc replacement . 

* Best fit algorithm gets the most out of conventional memory. 

* Use HMA, UMB, Video Memory, and EMS Page Frame. 

+ Full set of support routines, heapwalk etc. 


Run any program from your program! $1 69 
* Shell to any program, leaves less than 5K resident! 

* Saves and restores screen - text or graphics! 

* Swaps your program to expanded memory, extended memory or disk. 

* Easy to use, just a single call. 


aes Acomplete virtual memory system! $1 49 
—— mem * Handle based malloc replacement. 
— « Manages expanded, extended, and can swap to disk. 
* Eliminates memory fragmentation problems. 
* Optionally emulates Windows & Macintosh memory managers. 


Easy access to all memory! 
. oh pee multi-megabyte arrays in expanded, extended, or on disk. $99 
* Fast - 100% assembly language, dynamic array her sphaae 

» Read and write expaixéed or extanded Memory witn simple file like calls. 
= Complete set of calls to EMS and XMS managers. 


To Order Call: 

1-800-755-7973 Kandu Inc. 
International: (cog) Snrora 16 Ms oe Jersey 08680 
Fax: (609) 587-9412 


ALL OUR PRODUCTS FEATURE: - Source code » Suppports Microsoft, Bortand & Zortech C/C++ 
* 30 Day Money-back Guarantee «No Royalties! + 100% Assembler -» Free technical 
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Universal 
Printer 


S L AT E Driver 


Would Text and Graphic 
Printer support for over 
750 Printers (including 
PostScript) give you a 
competitive edge? 


By including SLATE, you can print 
both Text and Graphics on over 750 
printers (including PostScript, 
LaserJet I!l and the new Epson 
scalable font printers). 
Immediately! Painlessly! 


You can use SLATE in your product 
with no royalties. 


SLATE gets you out of the printer 
support business. Forever! 


Make your product more functional 
and competitive by using SLATE's 
advanced text features: 

+ Support multiple printers on the same 
system. 

* Output to parallel printers, serial printers, 
DOS files‘devices, DOS print spooler, 
and Novell network printers. 

* Include end user's soft fonts. 

+ Support cartridge fonts. 

+ Support proportional fonts 

+ Support scalable font printers. 

« Set exact print positions. 

* Color printing 

+ Keming, leading, overstrike, underlining, 
and strike through. 

+ Automatic character set conversion. 
SLATE with Graphics adds advanced 
graphic printing features: 

* Print images from the screen, PCX or TIFF 

files, or custom image systems. 

* Scale and Rotate the printed image. 

« Print grey scale and color images. 

« Intermix text and graphics. 
SLATE is a set of C or Basic libraries 
with over 170 text printing functions, 
a Database of over 750 printers, 
and End User configuration and 
testing programs. 


SLATE with Graphics adds over 60 
graphic printing functions. 


Call now for a complete developer's 
information kit. Order SLATE for 
only $299 or SLATE with Graphics 
for $448 with our risk free, 30 day 
return policy. 


We accept Visa, MasterCard, COD's or PO's 
from qualified companies. Source code, 
maintenance, and site licenses are available. 


800-346-3938 
Te Cokin ADs 
Symmetry Qeins 


614-431-2667 
Group _FAx 614-431-5734 
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clements corresponding to the structure 
in Listing 1. 

Storing tries as source code in the 
lexical analyzer can make for very large 
source files. Even a small language can 
have a search trie that is 1100 lines of 
source code. Such a file compiles to a 
relatively small amount of data, but just 
as no program is ever fast enough, no 
program is ever small enough either. 
Roughly half to two-thirds of the 
memory that a trie uses is for storing 
pointers to sub-tries. To minimize the 
memory requirements of a search trie 


after compilation, you should exploit 
your compiler’s options to group data 
together. Doing so lets you use a 
smaller pointer size to reference that 
data. 

In order to make creating and main- 
taining lexical analyzers that use tries 
easier, I've written a program that ac- 
cepts a text file of token words and 
token define names, creates the trie in 
memory, and dumps the trie to stand- 
ard out as static C data arrays. This 
scheme facilitates adding or deleting a 
word from the trie. 


Listing 3 


Y Aahehahahahahehehahahehahahehaleiehahaheiahehehahshehahaheheiahaheheiehahehahahshehahahahaiaichaheialalolchehehaishahaheheisiahaiaheheiaiaiahehsheiainiehehel 


* Module H 


Lexical Analyzer --- Header file containing token value 


enumeration, type definitions and function prototypes for 
the lexical analyzer functions. 


Copyright (C) 1990 John W. M. Stevens, All Rights Reserved 


* Author John W. M. Stevens 


baba hahatahatabatahahahehahahahehhahehalahahehahehshehahehehahehahehabaiebaishahelaiehehabaihaiahabsbalchaisleheislaieiaishsialsieisisiaiainiaisieiahalalal | 


tif ! defined( LEXICAL_ANALYZER ) 
fdefine LEXICAL_ANALYZER 1 
finclude <dos.h> 
fdefine TRUE 1 
fdefine FALSE 0 
#define ERROR -1 
fdefine OK 0 
fdefine PATH_SZ 65 

typedef unsigned int UINT; 
typedef unsigned char UCHAR; 
typedef char PATH[PATH_SZ] ; 


/* Definition of structure filled in and returned by lex. */ 


typedef struct { 
char str(257]; 
long no; 
struct time 
struct date 
) TOKEN; 


ftime; 
fdate; 


/* Token defines. */ 
enum tknien { 
STRING = 128, 
NUMBER, TIME, DATE, 


COMMA, 
ARCHIVE, 


L_PAREN, R_PAREN, 
AFTER, AND, 
DIRECTORY T, EXEC, 
MODIFIED, NAME, 
READONLY, RECURS, 
L_BRACE, BAR, 

}s 


typedef enum tkn_en TKNS; 


/* Function prototypes. */ 


extern TKNS 
extern void 
extern void 


Lex(TOKEN *); 
OpenPrg(char *); 
ParsErr(char *); 


fendif 
/* End of File */ 


F_SLASH, 
ATTRIBUTES, BEFORE, 
HIDDEN, LABEL, 
OR, PRINT, 
SELECT, SYSTEM, 


ACTION, 
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Example Lexical Analyzer 


The example lexical analyzer uses a 
trie that contains the keywords and 
token values defined in Listing 2. The 
first word on the line is the keyword, 
and the second word is the token value 
enumeration label for that keyword. 
The trie creation program processes this 
file. The program output is captured in 
a file that will be included in the source 
code file for the lexical analyzer. 

Listing 3 contains the token value 
enumeration, function prototypes, and 
type definitions necessary to use the 
lexical analyzer. To increase the 
readability of the parser source code, 
I’ve selected enumeration labels that are 
as similar as possible to the keywords 
they represent. Because of name space 
collision with type and/or define names 
used by the C compiler, some of the 
enumeration labels are postfixed with 
the string _T. 


(text continued on page 83) 


Listing 4 
[POCA AORERAAEE DAHER AHEM EHEEE EERE AAD EDRRAREDEADOOEROREAESEEREEERAROAHORERONEA HH 


* Module : Lexical Analyzer --- Process the input text file into tokens 
that the parser can understand, 


Copyright (C) 1990 John W. M. Stevens, All Rights Reserved 


Routines =: Lex - Return the next token from the file. 
OpenPrg - Open the source file. 
ParsErr - Report a parsing error. 


* Author : John W. M. Stevens 


RERRERAN RARE ERASE EER ESSE EEAAIREEHHENEEROEHEEHEROEERERERORDHREERAHORSEREROAD NES 


#include <stdio.h> 
finclude <stdlib.h> 
#include <ctype.h> 
finclude <string.h> 


finclude “Tex.h" 


/* Structure of trie branch. */ 
typedef struct key st [ 

char CH 

TKNS token; 

struct key st “child; 
} NODE; 


/* Constants local to this file. / 
idefine MAX_STR 256 
fdefine NOT_FND -2 


/* Object Data. */ 

static char word[MAX_STR + 1]; /* Last string analyzed. 

static char Prvwd [HAX_ STR + 1]; /* Previous word. 

static int LnNo = 0; /* The current line number in the file. 
static FILE *PrgFl; /* File pointer. 


has Never Been Easier 


Introducing WinTRAN™, the multi-platform GUI development 
environment that lets you manipulate named visual objects from 
your C or C++ code. As a result, applications developed with 
WinTRAN contain from one-half to one tenth the lines of code of 
GUI applications developed with any other approach. 
WinTRAN's powerful visual 
interactively build your applications' user interface for all 
popular GUI environments: Windows, PM, OSF/Motif, OpenLook 


and Macintosh. 


It's never been easier to develop GUI applications — for just 


one platform, or for all. 


Call today for more information 1-800-257-4888 


a@ GUIDEWARE 


2483 Old Middlefield Way, Suite 224, Mountain View CA 94043 


interface builder lets you 


CORPORA T 


WinTRAN Is a trademark of Guideware Corporation. All other trademarks are the property of their respective owners. 
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Listing 4 — Cont’d 


/* Irie data structure containing all the keywords and punctuation 
marks for 
the language being tokenized. 


T5[2) = { 
die 2, NULL }, 
‘a', ACTION, NULL } 


static 
NODE 


“Without a doubt, OPUS Make 
is the hottest make utility 

on the market” 

Tom Swan, PCWorld 


static 

NODE 116[2] = { 
ieee 2, NULL \. 

{ 's', ATTRIBUTES, NULL =} 


T15[2] = { 


OPUS Make is the superior choice NODE T14(2] = { 
ina make utility. Itis the fastest most a 
full-featured make utility there is. 


Features include: 


‘ 2, NULL}, 
{ 't', 0, T15 } 


For professional programmers, © 


hs 


static 
NODE 113(2] 
oe 
, 


iy 
~ 


@ DOS version uses only 3K memory! 

B Multiple directory support. 

Supports: Polytron PYCS™ 
Burton Systems TLIB™ 


Microsoft LIB™ 
SLR Systems OPTLIB™ 
@ Generates automatic response files of 
unlimited length for LINK and LIB. 
m@ OPUS MKMF included: An automatic de- 


2, NULL}, 
0 


{ ‘uy » 714 } 


pendency generator that fully under- 
stands C preprocessor directives. 


eet ait and OS/2 executables 
aranly: MC, Visa, COD 
$ 729 PO. 60 day MBG! 
Call 1-800-248-OPUS 
Internationa: 415-664-7901 


1032 Irving Street, Suite 439, San Francisca, CA 94122 
Trademarks owned by thelr respective compacies 
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static 

NODE T11[2] = { 
{ '', 2, NULL}, 
{ ‘, 0, 712 } 

}s 


—— Oe 


ee 


NODE  Tr0[2] = { 


’ 
; ‘rt, 0, Thi } 


Tf(2] = { 
, 2%, 2, NULL}, 
fb tt; 0, T10 } 


T1(6] = { 
» NULL), 


Tib[2] = { 


’ . 
( e', BEFORE, 


static 
NODE Tia[2] = ( 


C ts, 0, Tlb } 


static 
NODE T19(2] = { 


AccSys for Paradox. 


Because you shouldn’t 
be stuck 
pulling the engine. 


= 100% compatibility guaranteed 
= Support for ALL popular C & C++ compilers 
= Twice the speed and half the size (DBA, May '91) 


@ C Source available for all 
memory models 


Copia 
International 


VOICE: 708/682-8898 
FAX: 708/665-9841 Ltd, 


Ideal Wheaton, Illinois 60187 
for . _ 
Windows 3.0 


For technical details: 708/924-7465 doc. no. 889829 
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static 
NODE T18(2) » { 


(oe 2, NULL), 
ot 


NODE T17(2] = { 


{ '', » NULL}, 


on 


NODE  123(2] = { 


{ £4, 2, NULL}, 
"y', DIRECTORY_T, NULL =} 


Te2[2] = { 
rr, 0, 123 } 


T21(2] = { 


{ ‘o', , 122 } 


static 

NODE  T20(2] = { 

{ *% 2, NULL }. 
{ ‘t', 0, 121 } 


Plus l/ 


Screen Generator and User Interface Library for ‘C’ 


PANEL Plus I features: Interactive screen design editor 
* C and MS-FORTRAN code generators « library of 
user-interface functions * pop-up fields/windows + 
multi-line fields * mouse support * scrolling regions/ 
scroll bars * help boxes * pull-down menus * custom 
validation * shadow borders * complete library source, 
with low-level source and headers for all supported 
systems (DOS, OS/2, Unix, VMS) «= interfaces to popular 
PC graphics libraries * OS/2 DLL °* no royalties. 


: Utility Source Option which allows 
PANEL Plus II to be ported to any suitable development 
platform. New in v2.1: CUA/SAA key assignments and 
edit functions, CUA ‘function key area’ support, new 
menu styles, word-wrap editing, QH on-line help, 
DOS-extender interfaces, extensive example programs. 


Panel Plus I license fee per programmer: $495 {including 
library source and 700-page manual). Panel Plus II 
with utility source: $1195. Call for free demo disk. 

Instant Info via fax: dial (708) 924 7465, press 3702# 


Roundhill Computer Sys Systems | Limited 


Telephone: (7068) 690 3737 « Fat fn] 668 9841 © BOK: join round 
UK Head Office: POB 14 Marborough, Wituhie SNS 1LG @ Tet @672 84535 © Fax: 0672 B4525 
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static 
NODE 


( 
hs 


static 
NODE 


static 
NODE 


Tat(2) * { 


*e', 


Tie[2] = ( 


Tdf2) ={ 


‘n 


Tic(2) = { 


i 


126(2] = { 


2, NULL 


‘e', EXEC, NULL 


T2s 


(2) = { 
; 2, NULL 
. 0, 126} 


Moving from FORTRAN to C? 
™ WwW 
FOR_C"telves Gea 


C translations unmatched YQ 
for readability and style! 


FOR_C translates to standard C functions like 
fprintf() and strcpy(), with less dependence on 
custom functions. It checks arguments for 
consistent usage, selecting pass by value trans- 
lations when possible, and produces excellent C 
code! Popular FORTRAN extensions like VAX F-77 
with structures are supported, also making 
FOR_C a valuable porting tool. 


We include source to very portable runtime 
libraries so you can run your C code across 
different environments! 


Cost effective after only a 1000 tine translation, 
FOR_C makes machine conversion truly practical. 
Don't just take our word for it— put FOR_C to 
the test and judge the results! 


Call for information and combined 

product discounts. 

Ask about FOR_STRUCT and PRO_STRUCT, 
our new utilitles to convert spaghett! FORTRAN 
into fully structured code! 


COBALT BLUE 
——— 


875 Old Roswell Rd., Suite D-400 
Roswell, GA 30076, USA 
TEL (404) 518-1116, FAX (404) 640-1182 
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static 
NODE 


static 
NODE 


{ 
‘5 


static 
NODE 


static 
NODE 


{ 
hs 


static 
NODE 


T29[2] 


128[2] 


re 


T27(2) 


au 


T2f [2] 


. 
'n', 


T2e[2) 


tet, 


T2d[2] = { 
'q' 


T2e[2] = { 


. 
'd', 


Tab(2] = { 
qe 


733[2] = { 


T32[2] = { 


731[2] = { 
‘bee 
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T30[2] » { 


T3a(2] = ( 
" 2, NULL ), 
MODIFIED, 


af 


Graphical Instrument Libra 


The universal library for building 
fast graphical displays for data 
acquisition and control. 


fot Value — 


Rich set of instruments includes: 
Dial gauges, bar gauges, thermometers, seven-segment 
displays, strip-charts. annunciators, alarms, siqnal 
conditioning, timing, PID contrat and more! 


All instruments are fully scalable. Virtual coordinates 
allow programs to run unmodified on over 27 video modes! 
Works with any data acquisition hardware, 
even seriat-based systems! 


One version supports Turbo C, Microsoft C, QuickC. 
QuickBASIC, Turbo Pascal and others available soon. 


For a free derno, call 


(404) 352-4788 


1920 Moores Mill Rd., Atlanta, GA 30318 
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static 
NODE 


static 
NODE = { 


static 
NODE 


2, 
RECURS, 


static 
NODE 


static 
NODE 755[2] 

( -F%y 2, NULL }, 
SELECT, 


u 
~ 


static 
NODE 


BASIC to C translator 


¢ inputs BASICA, Quick BASIC 
¢ outputs MS/Quick/Turbo C[++] 

« CUTOMIZER™ for other BASIC 
* restructures any spaghetti code 
¢ indented, scoped, modulized C 

¢ syntax-error free, portable C 

* runtime library written in C 

¢ run on MSDOS, XENIX, UNIX 
* 1,000 copies sold since 1986 
FREE DEMO DISK, INFO 
Gotoless Conversion 


7105 Dee Cole Drive, The Colony, TX 75056 
Phone (214) 625 - 2323 


Fax: 214-370-2612 BBS: 214-625-6905 


static 
NODE 


2, NULL 
SYSTEM, NULL } 


static 
NODE 758(2] = { 


Listing 4 — Cont’d 


static 
NODE 


static 
NODE 


{ 

( 

{ 
ys 


21; 
L_PAREN, 
R_PAREN, 

COMMA, 
F_SLASH, 


End the DOS Nightmare! 
Wake Up to InCommand 


If working with DOS during the day is keeping you up at 
night, it's time to get InCommand! 


PCM Magazine Publisher's Pick 10/91 


"A powerful supplement to DOS.... Microsoft should 
have thought of these InCommand utilities."* 


-Text Search: full screen browse, line modes, whole-word-only 
option, more features than Norton 

*Execute: run your own programs and batch files as if they 
had all the InCommand file selection capabilities 

+Move (without copying), Rename, Delete, Directory (sorted, 
including file find): files, directories, or entire trees 

«Copy: multiple floppies in one command; incremental backups 
Up to 40% faster to floppies than XCOPY 

*On-line InCommand & DOS reference ("Better than DOS 5.0’s™) 

*Physical directory sort, network compatible, and much more! 


Productivity You Only Dreamed Of, Until Now! 


Run right from the DOS prompt. No menus to slow you down. 
Multiple ¥s in file and directory wildcards. 
Select (and exclude) multiple wildcard patterns at once. 
Select files BEFORE, AFTER, or ON any date/time, BIGGER or SMALLER 
than any size, with or without any attributes. 
Process entire directory trees as easily 
as one file. 
"Quoted trom PCM Magazine, 2/92. 
Much more! Only $60 
Call now for demo disk. San Diego, CA 92196 
You can rest easy with InCommand. (619) 578-5146 


Intelligent Software for Every User 
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730 }, 
734 }, 
T3b }, 
T3f }, 
T40 }, 
744 }, 
T4e }, 
NULL 

NULL 

NULL 


OpenPrg() --- Open the ASCII text file 
that contains the back up program. 


| Routine : 


| Inputs :  FileNm = File name of source file. 


void OpenPrg(char *FileNm) 


/* Open the program script file. */ 
if ((PrgFl = fopen(FileNm, “rt")) == NULL) 
{ 
fprintf(stderr, “OpenPrg (fopen) : Could not open 
file '%s' for “ 
"reading.\n", FileNm); 
exit( -1 ); 


/* Initialize object variables. */ 
*word = *PrvWd = '\0'; 


TIFF, PCX, & GIF 
SDK FOR WINDOWS 3.0 


Add support to you Windows Application 
without learning file formats! 


TIFF SDK For Windows is acomplete set of easy-to-use tools for] 
adding TIFF 5.0 support to your application without learning the 
complexity of Tag |mage Eile Format. Features include supportfor. 
Group 3and Group 4 fax file formats, LZW and Packbit compression, 
24-bit color images, chained images and device independent 
bitmaps. Includes full documentation plus a sample application 
complete with source code. Only $299.95 


PCX & GIF SDK For Windows adds the latest 24-bit color support 
toyour application. Includes documentation plus asample program 
Each Only $149.95 | 


complete with source code. 


IMAGE SDK For Windows contains functions to read, write, and 
manipulate Microsoft Windows CLP, WMF, BMP, and MSP file 
formats. Zooms, inverts, & rotates bitmaps. Comes with 
documentation, sample program and source code.Only $199.95 


NEW!! Color Generic Device Driver for Windows Now you can 
output high resolution TIFF, PCX & GIF, 100-600 DPI, compatable 
with any Windows application with capability to print. Only $199.95 | 
All SDK's are compatable with Visual Basic, SQL 
s. Windows, Actor, MS Excel and Borland C++ 


x 
\ BLACK ICE SOFTWARE INC. 
U i Crane Road, Somers N.Y. 10589 
WS TEL: (914) 277-7006 FAX: (914) 276-8418 
VISA/M.C/C.O.D/CHECK 
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Code Generator for 
Rule-Based Systems 


sae . 
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Build, test, verify, document, gen- 

erate C source code, and embed 

rule-based systems quickly with... 
Knowledge Shop” 


Rules are used in industry every day. If you haven't 
tried rule-based systems in your programs, consider 
where others have: policy and loan evaluation, 
stock and bond selection, equipment mainte- 
nance and diagnostics, systems design, part 
design, process monitoring and control, product 
selection and configuration, training - the list goes 
on and on. 


Knowledge Shop brings fast, portable rule-based 
teasoning to any C or C++ program. With Knowl- 
edge Shop's simple visual approach, you link nodes 
into a dataflow diagram that models the problem, 
import or create rules to specity processing at each 
node, then automatically generate portable, compact 
ANS! C source code that seamlessly embeds into 
your program. 


"I don't know where I'd be without Knowledge 
Shop" Bruce Harper, NextWave Software 


* Import or merge text rules at any time 

+ Automatic color-coded rule debugging 

+ Automatic generation of missing rules to cover gaps 
+ Automatic generation of documentation 

* Automatic generation of ANSI C source code 

* Complete portability of generated C code 

* Seamless embedding into any C or C++ program 
* Hooks for input, output, or error processing 


= a 


Honda of America = 
NextWave Software » Los Alamos National 
Lab » US Dept. of Commerce » Microway 
Software » Marketing Resources « Lehigh 
\% University * Univ. of Connecticut... 


Try Knowledge Shop for 15 days for $30! 
Includes the full program and manual. Keep it and 
pay the $465 balance or return it with no further 
obligation 


30-Day Money Back Guarantee! 


= = $495 aratial 
1-203-632-7570 
Fax: 1-203-635-3839 


Decision System Software 
160 West Street 
Cromwell, Connecticut 06416 


Rlequ.es IBM compatble. 640K. CGA. or better color display, DOS 
2.1 of higher. Knowledge Shop ss a trademark of Decision System 
Software. CT residents add 6% sales lax 
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| Routine; 


| Inputs 


ParsE€rr(char 


Listing 4 — Cont'd 


ParsErr() --- Report a parse error. 


Err ~ Error string. 


*Err) 


/* Print line number and error message. */ 
fprintf(stderr, “Error in Line: %d, %s.\n", LnNo + 1, Err); 


/* If there is a previous word, show it. *] 


if ( 


‘word ) 


fprintf(stderr, “\tOn or after word '%s'\n", word); 
exit( -1 ); 


TrieSrch() --- Search the trie for a key word. 


Trie - The trie level pointer. 
ch - The current character to search for. 
WordPtr - The pointer to the current byte of the word buffer. 
Returns either a token value or 
NOT_FND - For key word not found. 
- For end of file. 


TrieSrch(NODE 


register int 


regi 


auto 
auto 


int ch, 
char *WordPtr) 


mid; /* Mid point of array piece. 


ster TKNS ret; /* Return value of comparison. 
int 10; /* Limits of current array piece for 


int his /* binary search. 


/* Make sure that input is lower case. */ 


ch = 


/*s 
hi = 
lo = 
do 
{ 


} wi 


/* 1 


tolower( ch ); 


earch for a token. */ 
Trie[0].token - 1; 
1; 


/* Find mid point of current array piece. 
mid = (lo + hi) >> 1; 


/* Do character comparison. */ 
ret = ch - Trie[mid] .c; 


/* Fix the array limits. */ 
if (ret <= 0) 

hi = mid - 1; 
if (ret >= 0) 

lo = mid + 1; 


hile (hi >= lo); 


f the character matches one of the entries in this level and this 
entry has a child, recurse. If a match is found but the matching 
entry has no child, return the token value associated with the 
match. If the return value from the recursive call indicates that 
no match was found at a lower level, return the token value 
associated with the match at this level of the trie. 


if (ret == 0) 
{ 


/* Save the current character in the buffer for error reporting. */ 
*WordPtr++ = ch; 
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The C Users Journal 


As the leading international resource for C programmers, The C Users Journal provides you 
with practical tools and useful information. Every four weeks The Journal delivers “how to” 
insight, written by programmers for programmers. 


As the successor to The CUG Newsletter (1981) and The C Journal (1984), The C Users Journal 
has published continuously since 1987. 
Subscribe now — only $29.95 for a full year of The C Users Journal! 


Fill out the handy order form (on reverse side), or use one of our postage paid cards (found 
elsewhere in The Journal). 


The C Users’ Group collects and maintains public domain source code (our library now 
includes over 200 volumes), translates and distributes materials from the library in more than 
100 different formats, and helps members find the programs, consultants and other resources 
they need to do their job well. 


The CUG User Supported C Source Code Directory provides clear, file-by-file descriptions of 
volumes in the CUG library. Each volume of The Directory includes an index with keywords 
and extensive articles describing the most important volumes. 
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The C Users Bookstore 


The C Users Bookstore is your resource center for C programming books. We offer: 


© One stop shopping 
© Hard-to-find books 
® One low price (no hidden fees!) 


Don’t waste time wandering from bookstore to bookstore! The C Users Bookstore maintains 
a list of the best books on C and Unix programming, books like Illustrated C, MS-DOS System 
Programming, Second Edition, and C++ Programming Guidelines. 

The C Users Bookstore makes it easy - just use our order form (opposite page) to pick the books 
you want. Drop your order in the mail and relax. We mail most orders within 48 hours of receipt. 


Use Our Handy Order Form On Reverse Side 


1601 West 23rd St., Suite 200, P.O. Box 3127, 
Lawrence, KS 66046-0127 (913) 841-1631 
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The Resource Center for C Programming Books 


Hard-to-find titles and titles you won’t find anywhere else 
C++ e UNIX ¢ ANSI/StandardC ¢ TurboC e¢ Windows * X Window 


(lustrated C MS-DOS System Programming / 
2nd edition 


Edited by Robert Ward 


Soecond edition 


; vet ' By Leor Zolman 
pale \{ PA: ; eereh| _ lilustrated C explores the construction of 
wy ra : ‘ several different applications, from start to 


ke ; ical 

r ie finish. Through a focus on building useful, prac- e Lb aa el Nat weeblng 
tical programs, thls book gives the C program oer als n 
mor the “why and how" af appllcatian:design °, programmers and designed to save the reader 


hours of work. How-to topics Include: critical 
error handling, customizing the DOS boot 
strap, interruptdriven 1/O, manipulating en 
vironmental variables, event timing, writing 
TSRs and device drivers, and much more. The 
final chapter is an annotated bibliography of 
books designed to help the serious program- 
mer develop a personal library of professional 


» 

and development. Each program is exhaustive: a 

ly annotated in a clear, ceadable style. © 
illustrated C is a tutorial for the novice to MS- Ss 
Intermediate programmer and a toolbox for all 

C programmers. a ER OE 


R&D Publications, 1992, 320 pp. system programming 
ISBN 0-923667-21-0 


ILLUSTRATED 


C 


edited 6 
Leor Zolman WS Bhi e ceca one nonans $29.95 Soeert vikAD MS-DOS literature. 
W36 w/ disk ......0e0005 $39.95 R&D Publications, 1991, 240 pp. 
Covora UNIX and DOS platforma ISBN 0-923667-20-2 
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C++ Programming Guidelines 
By Thomas Plum and Dan Saks 
C++ Programming Guldelines gives professional 
C++ developers useful information for writing 
portable and maintainable C++ programs. Writ- 
ten for the professional C and C++ programmer, 


Fire The Standard C Library 


STA N DA R D By P.J. Plauger 


The Standard C Library shows you how to use 


| 
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this book aids the production of efficient, portable —— all of the library functions mandated by the 

programs which can be understoad and main- I - ANSI and ISO Standards for the programming, 

tained by other developers. Users leam both Af language C. To help you understand how to 

lexical layout and more fundamental semantics { ( use the library, this book also shows you how 

Pd store] PN LTS eq for data and variables, operators, control stale \ \ j to implement it. Approximately 9,000 lines 

GUIDELINES ments, and functions. C++ Programming ee ae of tested, working code that is highly port- 
( Guidelines is arranged in a “manualpage” format ee; 


able across diverse computer architectures 


3 Be gui for easy reference. | LI BRA RY is included. 


a Plum-Hall, 1992, 265 pp. Prentice Hall, 1991, 498 pp. 


ISBN 0-911537-10-4 ; ISBN 0-13-131509-9 
ee 33 ............ vee $34.95 PU PLAUOER ZAIN Aes ee iarcnies $28.00 


Use the order form on the opposite page to order these titles 
or any of 150 books in the Bookstore. 


FREE 1992 C Users Bookstore Guide 


Get your complete listing and description of all the books in the C Users 
Bookstore. The 24-page reference guide is yours for the asking. 
Titles are arranged by subject for easy reference and are indexed 
by title and author. 


CALL TODAY — (913) 841-1631. Or, use the Reader Service card in this 


magazine. Request 153 on the Reader Service Card. 
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The C Users’ Group collects and maintains the public domain C source code and shareware listed below. Distribution fee is $4.00 per disk. There 
isa S350 shipping and handling charge per order U.S; 30% overseas, If there are multiple disks in a volume, that number is indicated in 
parentheses, Due to upxiates, the number of disks per volume is subject to change without notice. The CUG Library supports code written for 


MS-DOS, CP/M and 


For volumes 101-156 sca the CUG 
Library Dinsctory. 
157 — QE for MSDOS 
158 — QE for BDS C 
159 — Adventure, MSDOS 
160 — Programs from Learning to 
Program In C (Plum Hall) 
161 — Programs from Efficlent C 
(Plum Hall) 
162 — Mchlp 80 
163 — Small C for MSDOS (PCC, 
Toronto) (2) 
164 — Windows 
165 — Programs from Rellable 
Data Structures in C (Pium 
Hall) 
166 — CUG Directory (#101- 
#155) 
167 — Windows, Unix-like Util 
168 — Simple Database (PC-SIG 
147) 
169 — Miscellany IV (PC-SIG 314) 
170 — Miscollany V (PC-SIG 315) 
171 — Miscellany Vi (PC-SIG 341) 
172 — LEX Part 1 
173 — LEX Part 2 
176 — Xlisp v 1.6 (2) 
177 — Dr. Shaw's DOS Shell 
{78 — TVX Source 
179 — TVX Doc & Exec. 
181 — CFORUM & Lzw 


182 — UNIX BBS 
183 — PC Tools I! 
184 — RunAMD 
185 — Sorts 


186 — Make & Aim 
187 — Functions IV 


188 — Utilities VI 

189 — PC Tools Ill 

190 — Steve Passe's 68K As- 
sembler 


191 — Miscellany Vil 

192 — Miscellany VIII 

193 — Crypto Toolbox 

194 — JUGPDS 17 

195 — JUGPDS 18 

196 — JUGPDS 19 

197 — MicroEmacs v 3.9 Exec. & 
Doc. 

198 — MicroEmacs v 3.9 Source (2) 

199 — GED MSDOS text editor 

200 — Small c Interpreter 

201 — MSDOS System Support 

202 — KAREL for MSDOS 

203 — YAM for MSDOS 

204 — 68000 C Compiler 

205 — Utilities VII 

206 — Checkbook Register Doc 
& Exec 

207 — Checkbook Register Doc 
& Source 

208 — e for CP/M 68K 


NIX, Volumes are continually added. 


209 — Simplex Curve Fitting 

210 — Simulation and Loadable 
BIOS for CP/M 

211 — Soarch, Sort and Merge 

212 — Simulation for BDS 

213 — Van Nuys Enhancements 

214 — Filo Display Util 

215 — BBS for BDS C 

216 — Zmodem & Saveram (2) 

217 — Spell & Dict Part t 

218 — Dict Part Il (2) 

219 — 6502 Cross Assemblers 

220 — Windows BOSS (3) 

221 — 6809 C for flex 

222 — Small C for CP/M Doc & 
Exec 

223 — Small C for CP/M Source (2) 

224 — Utilix 

225 — Utilities and Zmath 

226 — ART-CEE 

227 — Portable Graphics (2) 

228 — Miscellany IX 

229 — Little Smalitalk —UNIX Part 1 

230 — Little Smalitalk —UNIX Part 2 

231 — Little Smalltalk —Un- 
bundled Part 1 

232 — Little Smalltalk —Un- 
bundled Part 2 

233 — Make And Other Utilities 

234 — XDIR File and Maintenance 
Utilities 

235 — Overview File and Main- 
tenance Utilities (2) 


_ 236 — Highly Portable Utilities 


(CUG Starter Disk) 

237 — GRAD Graphics - main 
library 

238 — GRAD Graphics - demos 

239 — P.C. Gammon For MSC4 

240 — P.C. Gammon For Turbo 

241 — Inference Engine & Rule 
Based Compiler 

242 — Still More Cross As- 
semblers 

243 — DECUS C Preprocessor 

244 — deBruijn 

245 — Linear Cellular Automata 

246 — Cycles, Mandelbrot 
Graphics (2) 

247 — Miracl (3) 

248 — Micro Spell 

249 — C Spot Run Library (2) 

250 — 68K FP Library & Man- 
delbrot Graphics 

251 — Pull Down Menus & Adven- 
ture System 

252 — C Tutor Doc 

253 — C Tutor Source 

255 — EGA Graphics Library 

256 — DeSmet Carry Routines (2) 

257 — C Tutor doc (Turbo C) 

258 — C Tutor Source (Turbo C) 


259 — Consolo I/O & Withers 
Tools 

260 — Zmodem, CU, tty library 

261 — 68k Cross Assembler MS- 
DOS 

262 — Ramey Tools 

263 — C_wndw Toolkit (2) 

264 — NRO & Other PC Tools 

265 — cpio Installation Kit ¢ Call 
CUG for ordering Instruc- 
tlons (2) 

266 — Micro PLOX 

267 — 8085, 2650 & 2656 Cross 
Assemblers 

268 — Unicom Library Turbo C (2) 

269 — Unicom Library MSC 

270 — Miscellany X 

271 — Steven's Library Turbo C (2) 

272 — Steven's Library Datalight 
c 


273 — Turbo C Utilities 

274 — Arrays for C 

275 — Unear Cellular Automata Il (2) 

276 — Z80 and 6804 cross as- 
semblers 

277 — HP Plotter Library and 
XMODEM 

278 — CXL Function Library (3) 

279 — CROBOTS 

280 — Software Tools Souca 

281 — Unicorn Library v5.1 (2) 

282 — Quip and Graphics 

283 — FAFNIR (3) 

284 — Portable 8080 Emulator 

285 — Bison for MS-DOS (3) 

286 — GRAD for MSC (2) 

287 — GRAD for Turbo C (3) 

288 — Traveling Salesman, SD 
and Master Environment 


Access 
289 — Othello 
290 — FLEX (2) 


291 — JJB for Quick C & Turbo C 

292 — ASxox C Cross Assembers (4) 

293 — 3D Med. Imaging, Source (2) 

294 — 3D Med. Imaging, sample 
images (4) 

296 — C to C++ Migrator 

297 — Small Prolog 

298 — PC Curses 

299 — MEL and BP 

300 — MAT_LIB 

301 — BGI Applications (2) 

302 — 3-D Transforms 

303 — MC68K Disassembler 

304 — ROFFS 

305—HGA Mandelbrot Explorer 
/Card Games (2) 

306 — Threads and Synapsys 

307 — ADU & COMX (Device Driver) 

308 — MSU, REMZ & LIST (2) 

309 — 6809 C Compiler for MS-DOS 


310 — Little Smalltalk for MS-DOS 
(2) 

311 — DB package 

312 — Make-Maker 

313 — STEVIE 

314 — MNP C Library 

315 — FTGRAPH 

316 — AS& Cross Assembler 

317 — Group3 Image Processing 

318 — RED (2) 

319 — CPP (2) 

320 — Convolution Image Process 

321 — Mouse Trap Library 

322 — Doctor's Tools 

323 — Fireworks and Adventure 

324 — WGCONIO 

325 — VGA Graphics Library (2) 

326 — SoftC Database Library (2) 

327 — Panels for C 

328 — WTWG (2) 

329 — UNIX Tools for PC (2) 

330 — CTask (3) 

331 — SE Editor 

332 — PCcurses (2) 

333 — gAWK (2) 

334 — GNUPLOT (3) 

335 — Frankenstein Cross 
Assemblers (4) 

336 — EGAPAL/EDIPAL 

337 — Designing Screen 
Interfaces In C 

338 — 68K C Compiler and As- 
sembler (2) 

339 — CTRLCLIB (2) 

340 — C-Window 

341 — Orbit Propagation 

342 — 18255 Interface Library 

343 — C Image Processing Sys- 


tem (4) 

344 — Grab Bag #1 (2) 

345 — TLC/TLP 

346 — ASxox Cross Assembler 
Part 2 (2) 


347 — TAVL Tree 

348 — 8048 Disassembler/Z80 As- 
sembler 

349 — Simulation Subroutine Set 

350 — PCX Graphics Library 

351 — UltraWin 

352 — String and Vlist 

353 — C++ Tutor (2) 

354 — CES Mouse Tools Library 
w/ Joystick 

355 — Sherlock for MS-DOS (3) 

356 — Sherlock for Macintosh (3) 

357 — CSTAR (2) 

358 — cbase 

359 — GNU C/C++ for 386 (12) 

360 — Uspell (2) 

361 — Gadgets and Term 


Be sure to specify format when ordering disk. We can supply these volumes in almost any MS-DOS format (34" or 54"), 
UNIX tar or cpio archives (54" only), or Macintosh. 
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(text continued from page 71) 


Listing 4 contains the lexical 
analyzer. I’ve extracted this code from a 
program that acts as a user-program- 
mable file selection shell. The function 
OpenPrg() initializes the lexical analyzer 
by opening the file that contains the 
source code to be analyzed. The parser 
then calls the function Lex() repeatedly 
to get tokens. Each time Lex () is called, 
it begins by reading and throwing away 
both white space characters (space, tab 
and newline characters) and comments. 
When the first character of a suspected 
keyword is found, it breaks out of the 
loop and attempts to get either a string 
constant, integer constant, time, or date. 

If the input is not a constant of some 
type, the trie search function is called. 
The function TrieSrch() begins by at- 
tempting to find the input character in 
the trie node. TrieSrch() accepts a 
pointer to a node of a trie, a character 
to search for, and a pointer to a buffer 
for storing the word read from the input 
file. The function uses a binary search 
because the characters in a trie node 
are stored in sorted order. 

If the input character is found in the 
trie node, TrieSrch() saves it in the 
word buffer. If the matching character 
in the trie node has a pointer to a child 
trie node, TrieSrch() reads another 
character from the file and calls itself 
recursively. If the return value from the 
recursive call indicates that the charac- 
ter was not found, TrieSrch() assumes 
that the input character for this call was 
the last character of a legal word and 
unreads the character read for the 
recursive call. The token value of the 
input character to this call is returned. 

If the matching character does not 
have a pointer to a child trie node, the 
keyword buffer is NUL-terminated and 
the token value stored with the match- 
ing character is returned. If the input 
character is not found in the trie node, 
TrieSrch() NUL-terminates the keyword 
buffer and returns a value indicating 
that the character was not found. 

Figure 2 presents an algorithm in 
structured English for separating words 
from an input character stream and 
searching for them in a search trie. 


(text continued on page 85) 
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Listing 4 — Cont'd 


/* Are we looking for more characters in this string? */ 
if ( Trie({mid].child ) 
{ 


/* Get the next character. */ 
{f ((ch = fgetc( PrgFl )) == EOF) 
return( EOF ); 


/* Search next level. */ 
if ((ret = TrieSrch(Trie[mid].child, ch, WordPtr)) =»* NOT_FND) 


{ 
ungete(ch, PrgFl); 
return( Trie[mid].token ); 


return( ret ); 


else 


LANGUAGE 
_—7 Aine 5.0 presents 
— UM” CC Bug # 647 


void £( n, m ) 
{ 
long nm; 


This program fragment ported from Unix to MS-DOS doesn't work quite right. 
If you need help figurng out why, give us a call. Refer to Bug # 647. 


PC-lint will catch this and many other Attn: Power users with huge programs. 


C bugs. Unlike your compiler. PC-lint PC-lint 386 uses DOS Extender 
looks across all modules of your appli- Technology to access the full storage 
cation for bugs and inconsistencies. und flat model speed of your 386. Now 


‘ atible with Wi 8 3.0 
New — Optional Strong Type Checking aera wall Wows 


and variables possibly not initialized. : 
PC-lint 386 — $239 


More than 330 error messages. More ; 
. = D ix 
than 105 options for complete cus- PC-lint DOS - OSI2 - $139 


tomization. Suppress error messages, . _ 
locally or globally, by symbol name. by Mainframe & Mini Programmers 


message number, by filename. etc. FlexeLint in obfuscated source 

Check for portability problems. Alter form, is available for Unix, OS-9 

size of scalars. Adjust format of error if eo 

messages. Automatically generate ANSI VAXIVMS, QNX, ls VMIMVS, 

prototypes for your K&R functions. etc. Requires only K&R C to com- 
pile but supports ANSI. Call for 
pricing. 


Gimpel Software 
3207 Hogarth Lane, Collegeville, PA 19426 


CALL TODAY (215) 584-4261 Or FAX (215) 584-4266 
30 Day Money-back Guarantee. 
PA add 6% wales tar, PC-Lint and Flevel int are tratemorks of Gimpel Satin are 
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/* Properly NUL terminate the buffer that the keyword is 


* 


. being saved in and return the tok lue. 
Redefines */ rn the token value 


*WordPtr = "\O'; 


Productivity ,. see Trie[mid].token ); 


} 


with /* Terminate string in keyword buffer and return not found. * 
*WordPtr = '\O'; 


turn( NOT FND ); 
OREGON C++ —_ 


Productivity In the Small ' Routine : GetNo --- Get a number from the file. 

Compile directly fo object code, | Inputs : word - Pointer to word buffer for error reporting. 
eliminating all intermediate steps. | Outputs : RetNo ~- Returns the number read from the file. 

e Fast Compilation 
e Fast Debugging 
e Fast Code 


| Returns : Returns the last character read from the file or EOF. 


GetNo(char ‘**word, 


Productivity in the Large Jong *RetNo) 
Support for popular dialects. auto int; 
e K&RC 
I*G b 4] 
© ANSIC spetio = Oly 
© CH 2.1 pus ((c = fgetc( PrgFl )) >= '0' && c <= '9°) 
Support for popular platforms. /* Save character in word buffer. */ 
© Sun-4 (SPARC) “irsera| etm er 
e DECstation /* Calculate value of number. */ 
e VAX/VMS *RetNo = *RetNo * 10L + (long) (c - '0'); 


return( c ); 


Productivity in the tong term 
© TauMetric Support 
e TauMetric Expertise i :  Lex() --- Get the next key word from the input file. 


sym - The symbolic data read from the file. 
You probably have used our 


products under other names : Returns the token read or EOF. 
but now you can get our 

a TKNS Lex(TOKEN ‘*sym) 
support directly. { 


. register int 
TauMetric has developed OEM mapiexen” Ane 

Fs auto int 
C++ products since 1987, auto char 
including Oregon C++. We /* Strip comments and white space. If the character read is a ‘#', 
bought the Oregon Software * every thing to the end of the line is a comment. 

' : : ff 

product line and will support it ch = fgetc( PrgFl ) 


while releasing our exciting a (ch == 61 [[ch == t\th |] ch == ‘nt |] ch == 1#) 
new C++ products. /* Process the special characters '#' and '\n'. */ 
if (ch == '\n') 
/* End of line, increment the line number. */ 


Fd tauMerric et scoagts 
—U'I CORPORATION { 


id d 

8765 Fletcher Parkway, Suite 30 a na 
a Mesa, California */ 
(619)697-7607 FAX(619)697-1140 while (fgetc( PrgFl ) I= '\n') 


800-874-8501 elise 
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(text continued from page 83) 


Summary 


A trie is probably not the most effi- 
cient data structure for determining the 
legality of an input word. A sorted table 
of strings searched with a binary search 
would probably be faster and more 
memory efficient. 

So why use a trie if it isn’t as fast or 
efficient as other methods? Since the 
hardest part of writing a lexical analyzer 
is in breaking an undifferentiated 
stream of input characters into words, 
the beauty of a trie is that it groups 
characters into words and determines 
their legality at the same time. It is also, 
in my opinion, a more elegant solution. 
This alone is reason enough for me to 
use a trie. 0 
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COMM-LOG 
Background filetransfer TSR 
Xmodem(1k)/Ymodem(Batch/G) 
Background loggingto disk TSA 
Application & Command Line Interface 


Filetransfar/logging on seperate ports / 
seperate files concurrently. Easy to use. 


TSRs are de-installable 


TSR & File Transfer Sources 
$89.95 


SCRN-INPUT 
@ Professional screen & keyboard library 
@ Craate screens on monitor or 


Listing 4 — Cont’d 


*/ 


Get the next character. 
= fgetc( PrgFl ); 


*/ 


strings, etc. 


as dl | 
Get contents of string. */ 
= sym->str3 
for (i = 0; 1 < MAX_STR; 14+) 
if ((ch = fgete( PrgFl )) Ie '"' && ch I= EOF) 
*bf++ = ch; 
else 
break; 
*bf = '\O's 


/* Return string token. 
strepy(word, sym->str); 
return( STRING ); 


else if (ch >= 'O' && ch <= '9') 


auto long 
/* Establish a pointer to the word buffer and unget the 
numeric character for re-reading. 


ungete(ch, PrgFl); 


/* Get number, time or date. */ 
if ((ch = GetNo(&bf, &no0)) == ':') 
{ 

/* Getting time, not number, */ 
“bf++ = chs 
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1-800-966-4832 
Willies' Computer Software Co, 
2470S. Dalry Ashford, Suite 188 
Houston, Texas 77077 
PO/COD/CHECK 


FAX (713)-568-3334 
BBS (713)-568-6401 


24 Hours/Day 7 Days/Wee 
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© Request 322 on Reader Service Card > 


The best cross platform, cross language editing tools just got better. If 
you need to Integrate text editing functions into your applications, the 
RSs _mIniEd family of editing products provides the answer. Handle 
RS document entry, pop-up windows, memo fields or any other formatted 
Ry text requirement with a simple call to a_miniEd function. 
Cross Platform: DOS / WINDOWS / UNIX 
6 Cross Language: 'C'/ BASIC / PASCAL / 
Re ASSEMBLER / MODULA 2 
RS Features: “Format-on-the-fly" word wrap technology 
wy All standard editing functions supported 
ey VIEW mode for formatted text display 
Se Works with any size screen window 
wi Full source code provided 
Ks Tools: _miniEd -RAM based editing In a 5K package 
we _minlEd Toolkit - File or RAM based editing 
Re NEW —minIWords - 150,000 words & support routines 
k= ComingInMay  =_miniSpell - add-In spell checking 


Oe 
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SESE EEL EY 


TEL (713)-498-4832 
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At SSDI, we don't take the word "mini" lightly. All __miniEd tools are 
compact, tightly structured modules that won't impose a size or 
performance overhead on your applications. The tools are priced from 
$99.00 to $349.00. To order or obtain more information call (708/778- 
6060) or FAX (708-778-6063). VISA and MC accepted. Please specify 
'C' or assembler source when ordering. 


Strategic Software Designs, Inc. 
Software Tools and Custom Development 
6S235 Steeple Run Drive - Sulte 12B - Naperville, IL 60540 
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Listing 4 — Cont'd 


sym->ftime.ti_hour © (unsigned char) no; 
sym->ftime.ti hund » (unsigned char) 0; 


/* Get minutes, I 
if ((ch = GetNo(&bf, &no)) == ':') 
{ 


/* Save minutes. */ 
*bfe+ = ch; 
sym->ftime.ti_min = (unsigned char) no; 


/* Get seconds. */ 
if ({ch = GetNo(&bf, &no)) == ',') 


“bf = ‘\O'; 
ParsErr( “Hundredths of seconds not allowed in ° 
"time expressions” ); 
} 


sym->ftime.ti_sec = (unsigned char) no; 


else 

{ 
/* No seconds to get. */ 
sym->ftime.ti_min = (unsigned char) no; 
sym->ftime.ti_sec = (unsigned char) 0; 


} 


/* This is atime. */ 
tkn = TIME; 


} 
else if (ch == '/') 
/* Getting date, not number. */ 


“bf++ = ch; 
sym->fdate.da_mon = (char) no; 


(smx) simple multitasking executive 


Cut Embedded Programming Cost! 


Are you reinventing the wheel? ... trying to write your own 
kernel? High-performance microprocessors, low-cost memory, 
and sux have made this unnecessary. six costs a small 
fraction of what “"home-brew" kernels cost to develop. Besides 
the programming time to write one, debugging is always harder 
than expected. And, when the home-brew is done, capabilities 
are usually disappointing. So what have you gained? 


smx is a general-purpose, carefully-désigned, reliable kernel. 
It has been in use for 3 years and already has a large base of 
satisfied customers. What home-brew kernel can match this? 


In addition, smx does extensive error checking and features a 
powerful task debugger, called smxProbe. smx also has 
well-written, accurate manuals, and it’s easy to learn and use. 
-.. Leave the kernel writing to the experts — buy six. 


CALL OR FAX TODAY FOR FULL DETAILS 


MICRO pd DIGITAL 1-800-366-2491 


6402 Tulagi St. Cypress CA 90630-5630 FAX 714-891-2363 
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Listing 4 — Cont’d 


/* Get day. e] 
4" ((ch = GetNo(&bf, &no)) e=# ‘/') 


/* Save character. */ 
*bf++ = ch; 
sym->fdate.da_day = (char) no; 


/* Get year, */ 

ch = GetNo(&bf, &no); 

if (no > 1980L) 
no -= 1980L; 

else if (no > BOL &8& no < 100L) 
no -= BOL; 

else 


“bf = ‘Nols 
ParsErr( "Error, bad year value in date expressfon.” ); 


} 
sym->fdate.da_year = (int) no; 


else 
{ 
“bf = ‘No’: 
Pars€rr( "Missing year in date expression” ); 


/* This is a date. */ 
tkn = DATE; 
} 


else 


/* Just an integer constant. «] 
sym->no = no3 
tkn = NUMBERS 


QNX: Preferred by Real-Time, 


Real-Time Multitasking 


for Microsoft C, Borland C, Turbo Pascal 
———————aEEEEE ee eee 


Performance Programmers 


Develop Real-Time Multitasking Applications with RTKernell 


ATKernel is a professional, high-performance, low-cost real-time multitasking kemel. It 
tuns under MS-DOS and supports Microsoft C, Borland C++, Turbo C++, and Turbo 
Pascal. ATKeme! Is a library you can link to your application. It lets you run several 
functions / procedures as parallel tasks. Join hundreds of satisfied customers who've 
been using RTKemel In the past three years. RTKemel offers these advanced features: 


DynaDos: 
Integrate favorite DOS applications into multi-user, 
multi-tasking QNX environment via direct Arcnet 
connection. Use QNX system as file server for DOS 
machines and as host for multi-user applications. 


© New TCP/IP 
© QNX Windows and associated tools 
© C86 and C++ Compilers 


© pre-emplive, event: / interupt-driven * activate tasks out of interrupt handlers 
scheduling * supports math coprocessor and emulator 

* number of tasks only limited by RAM * supporis COMI to COM4 

* lask-switch time of approx. 12 \secs extensible to any number of COM ports 
on a 33-MHz 486 ¢ interrupt handlers for keyboard and COM 


© performance independent of the number ports included with source code 
of lasks * resident multi-tasking applications (TSAs) @ Flexeli cod 

* use different priorities (changeable at * keyboard, hard disk, floppy disk idle times < Int Source e analyzer Ms 
tun-time) to control your tasks usable by other tasks © Edit 2000 for professional programming 


* time-slicing can be activated * runs under MS-DOS 3.0 to 5.0, DR-DOS, 
* programmable timer interrupt rate Novell, etc., or without operating system 
© high-resolution timer (approx. 1 sec) ¢ ROMable 
¢ inter-task communications using sema- * supports CodeView and Turbo Debugger 
phores, mailboxes, and message-passing * full source code available 
* call DOS from any number of tasks * no run-time royalties 
without re-enlrance problems! ¢ free technical support by phone or fax 


RTKernel-C (MSC 6.0, TC++ 1.0, BC++ 2.0) ... $445 (for source code, add $375) 
RTKernel-Pascal (TP 5.0, 5.5, 6.0) ...ssesssssssses $375 (for source code, add $325) 


For Intemational orders, add $30 for shipping and handling. 
Visa, check, bank transfer, or COD (in Europe) accepted. 


Please call or fax for our free demo disk. 


RAY 


KARSTEN PETERSEN 
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© QWC windows toolkit, Freeze, QWEdit, Scholar 
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P.O. Box 14010, Tulsa, OK 74159 USA 
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VISA/MC 
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Listing 4 — Cont’d 


/* Return the unused character. */ 
*bf e "NOs 

ungetc(ch, PrgFl); 

return( thn ); 


} 
else if (ch == EOF) 
return( EOF )}; 


* or NOT_FND. If not found, print an error and quit. 
sf 

if ((tkn = TrieSrch(TO, ch, word)) == NOT_FND) 
{ 


/* T)legal first character in word. */ 
if ( *PrvWd ) 


"word after '%s'.\n", LnNo + 1, PrvWd); 
else 


"first word in file.\n", LnNo + 1); 
exit( -1 ); 


} 
else if (tkn == 0) 


/* Wilegal word. */ 


“word 'ks'.\n", LnNo + 1, word); 
exit( -1 ); 


) 
strcpy(PrvWd, word); 


/* Return the token found. 
return( tkn ); 


*/ 
} 
/* End of File */ 


ANSI SQL DBMS FOR 
PROGRAMMERS, ONLY $195 


Supports - Turbo C © Turbo Pascal ¢ Microsoft C ¢ 
QuickBASIC ¢ MicroFocus COBOL 
All Compllers are trademarks of thelr respective Manutacturers. 
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single userfor Windows: $395 O CE LOT 
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Shipping & Handling: 
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Siener Soft 
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/* Call the trie search routine to return the next token, EOF 


fprintf(stderr, “Parse - Error in Line: %d, cannot identify * 


fprintf(stderr, “Parse - Error in Line: %d, cannot identify “ 


fprintf(stderr, “Parse - Error in Line: %d, cannot identify " 


BUILD A MINI-DATABASE 
SYSTEM WITH... 


Illustrated 


Leor Zolman 


CUJ columnist and 
author of BDS C 


wer 


Discover the WHY and HOW of application design 
and development in C. Explore the construction of 
several different applications from start to finish. 
Chapter after chapter you'll develop your skills 
through in-depth tutorial and detailed code. 


ath 1: E> (*392% with disk) 
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‘OLOOZsRax neschke, 


Allie iiteesenveds 


Rex Jaeschke 


Data Structures 


Part 11: Yet More on Stacks 


Handling Multiple Stacks of the Same Type 


Last month’s column described how to implement a stack 
and to use push and pop functions on it. However, it would be 


a waste to have a different set of push 
and pop functions for each stack. This 
month I will discuss how to share the 
code. 

Consider Listing 1. An object of 
type stack contains the current con- 
text of a given stack. This context in- 
cludes the stack’s name (for debugging 
or trace-back purposes), the base ad- 
dress of the stack, the stack’s size and 
its current stack pointer. The stack 
descriptors stack], stack2, and 
stack3 therefore describe the three 
different int stacks. The first stack is 
stored in a global array, the second in 
a file scope static array, while the third 
is allocated at runtime using malloc. 
In short, the stack management func- 
tions don’t know and don’t care where 
the stacks reside. 

Listing 2 tells push and pop which 
stack to use but the notation is not 
particularly unwieldy. Listing 3 could 
be made a little bit cleaner by passing 
the stack descriptor by value, but that 
could be just a little more expensive 


since the descriptor is a structure. The output produced is 


shown in Figure 1. 


Renee Mie WE Ecc, (oe 
-Doctor C’s Pointers 


Handling Multiple Stacks of Different Types 


Can this idea be extended to manage stacks of different 
types? The answer is a qualified yes. One way could be to use 


generic pointers, as shown in Listing 4. 
Here, a void pointer is used to hold 
the stack’s base address. This also re- 
quires an extra member to indicate 
the type of elements in any given 
stack, as in 


void push(stack *, void *); 
void *pop(stack *); 


The interface to push and pop gets 
very messy, however. Since an object 
of arbitrary type cannot be passed by 
value, it must be passed by assigning it 
to a named object and then passing 
that object by address, as shown in 
Listing 5. (This eliminates the ability 
to push a constant directly.) This is 
possible since all data pointer types 
are compatible with void *. Similarly, 
an arbitrary typed value can’t be 
returned, so the address is returned 
instead. 

To use the value returned by pop 
you must use an explicit cast as well as 
a dereference since pop returns a 


pointer (see Listing 6). In fact, since pop returns the address of 


the object just popped from the stack, if you don’t dereference 
the pointer returned immediately, the location it points to will 
be overwritten by the very next push and the value popped will 


change. 


Rex Jaeschke is an independent computer consultant, author, and seminar leader. He participates in both ANSI and ISO C Stand- 
ards meetings and is the editor of The Journal of C Language Translation, a quarterly publication aimed at implementors of C 
language translation tools. Readers are encouraged to submit column topics and suggestions to Rex at 2051 Swans Neck Way, Reston, 


VA 22091 or via UUCP at rex@aussie.com. 
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Listing 1 


finclude <stdio.h> 
@include <stdlib.h> 


fdefine NUMELEMENTS(x) (sizeof(x)/sizeof(x[0})) 


typedef struct { 
const char “stack_name; 
int *pstack; 
size_t stack_ptr; 
size_t max_stack; 

} stack; 


int array1[1); 
static int array2[30); 


stack stackl = {"stackl", arrayl, 0, NUMELEMENTS(array1)} 
stack stack2 = ("stack2", array2, 0, NUMELEMENTS(array2) } 
stack stack3 = {"stack3", NULL, 0, 0); 


/* End of File */ 


Listing 2 
void push(stack *, int); 
int pop(stack *); 


main() 
int size = 50; 


stack3.pstack = malloc(size * sizeof(int)); 

if (stack3.pstack == NULL) { 
printf("Can't allocate space for stack3\n"); 
exit(1); 


stack3.max_stack = size; 


push(&stackl, 10); 
push(&stackl, 12); 
push(&stack2, 15); 
push(&stack3, 20); 
printf("stkl: %d\n", pop(&stack1)) 
printf("stk2: %d\n", pop(&stack2) ) 
printf("stk3: %d\n", pop(&stack3)) 
printf(“stk3: %d\n", pop(&stack3) ) 


return 0; 


} 


/* End of File */ 


Listing 3 
void push(stack *st, int value) 


if (st->stack_ptr == st->max_stack) 

printf("Stack %s is full\n", st->stack_name); 
else 

st->pstack[st->stack_ptr++] = value; 


} 
int pop(stack *st) 
{ 


if (st->stack ptr == 0) { 
printf("Stack %s is empty\n", st->stack_name); 
return 0; 


} 


return st->pstack[-st->stack_ptr]; 


/* End of File */ 
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The source for push and pop is far from pretty. Since it 
cannot perform arithmetic (via subscripting) on vold pointers, 
you must explicitly provide the scaling factor. 


Using Unions 


Another way to look at the problem is rather than have 
stacks of different types, have one stack that can handle ob- 
jects of different types. You can achieve this via a union, as 
shown in Listing 7. 

Each entry is a union of all the possible types along with a 
flag member that indicates which type this entry currently rep- 
resents. We push nodes by value and return them by value 
using simple and obvious notation. If you try to pop from an 
empty stack, instead of complaining, pop returns a copy of a 
local node that has a special type field value of Error. 

Next, consider Listing 8. Note the interesting controlling 
expression in the while loop — it uses the comma operator in 
an effective manner. 

The stack management functions presented in Listing 9 are 
quite straightforward. 


Opposing Stacks 


A stack grows and shrinks from one end only so it is pos- 
sible to have two stacks based at opposite ends of an array 
with their tops growing toward each other. This can save space 
if both stacks don’t grow very large at the same time. However, 
when one is smaller, the other can grow larger and vice-versa. 

The dump_stack function in Listing 10 allows us to see the 
contents of the underlying array as the two stacks grow and 
shrink. Note that it pops in a different order than it pushes, so 
the operations are staggered. 


Figure 1 


Stack stack] is full 
stkl: 10 

stk2: 15 

stk3: 20 

Stack stack3 is empty 
stk3: 0 


Listing 5 
main() 
{ 
int size = 50; 
int vali = 10; 
long vall = 456789; 
double vald = 123.456; 


stack3.pstack = malloc(size * sizeof (double)); 
if (stack3.pstack 2= NULL) { 
printf("Can't allocate space for stack3\n"); 
exit(1); 
} 


stack3.max_stack = size; 


push(&stackl, &vali); 
push(&stack2, &vall); 
push(&stack3, &vald); 
printf(“stkl: %d\n", *((int *)pop(&stackl))); 
printf("stk2: %ld\n", *((long *)pop(&stack2)) 
printf("stk3: %f\n", *((double *)pop(&stack3) 


); 
3 


return 0; 


} 
/* End of File */ 
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Listing 4 


finclude <stdio.h> 
#include <stdlib.h> 


#define NUMELEMENTS(x) (sizeof (x)/sizeof(x(0])) 
fdefine INT 1 

fdefine LONG 2 

fdefine DOUBLE 3 


typedef struct { 
const char “stack_name; 
void *pstack; 
const int type; 
size_t stack_ptr; 
size_t max_stack; 
} stack; 


/* type of entries */ 


int arrayl[10]; 
static long array2[30]; 


stack stackl = ("stackl", arrayl, INT, 0, NUMELEMENTS(arrayl)}; 
stack stack2 = ("stack2", array2, LONG, 0, NUMELEMENTS(array2))}; 
stack stack3 = {"stack3", NULL, DOUBLE, 0, 0}; 


/* End of File */ 


Listing 6 


void push(stack “st, void “pvalue) 


if (st->stack_ptr == st->max_stack) 

printf("Stack %s is full\n", st->stack_name); 
else 

switch (st->type) { 


case INT: 
((int *)st->pstack) [st->stack_ptr++] = *(int *)pvalue; 
break; 


case LONG: 


((long *)st->pstack) [st->stack_ptr++] = *(long *)pvalue; 
break; 


case DOUBLE: 


((double *)st->pstack) [st->stack_ptr++] = *(double *)pvalue; 
break; 


} 


void “pop(stack *st) 


if (st->stack_ptr == 0) { 
printf("Stack %s is empty\n", st->stack_name); 
return 0; 


} 

switch (st->type) { 

case INT: 
return &((int *)st->pstack) [-st->stack_ptr] ; 
break; 

case LONG: 
return &((long *)st->pstack) [-st->stack_ptr] ; 
break; 

case DOUBLE: 


return &((long *)st->pstack) [-st->stack_ptr]; 
break; 


} 
/* End of File */ 
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sinclude «stdlo.h> 

text count()(Int c,ol Snes, meords nchers, imeord; 
inword=WO:nb ines emordsenchart<O;ehile((e 
egatchar() 1eEOF deencherssif (co*"\n') 
eentiness tf (Cee! ")ii{cwe'\n") pirecrd-R0 else 
1f( {meordaeNO) { trworda¥E5S;0smmeordss))pr inet 
"td Ad Ad\n“,ni ines, mwords ,Achars)3) 


finclude <stdio.h> 

ftext_count () 

: int c, nlines, meords, nechars, {meord; 
ineord = AO; 


nifnes = mwords = rchars « 0; 
whila ((e © getchar()) t= EOF) { 


Inward = YES; 
¢snwords; 
} 


} 
printf ("&d 4d Sd\n*, niines, meards, nchars); 


(One of an infinite number of styles) 


N 0 with C-Clearly,” format C source 
code exactly the way you want 

it. C-Clearly’s context sensitive analysis will 

format any C program in your own personal 


or corporate style. 

EAS to use, C-Clearly’s style templates 
are a snap to modify, since they 

resemble C source code you edit into your 

preferred format. Templates are included for 

several common styles as well as standard 

K&R. 


LISTI N G S can also be created with 
function names and 
comments highlighted for improved readability. 


Listing options include line numbers, headers 
and/or footers and flow lines. 


| D FAL for making obtuse code clear. 
Allows all of your source code 

to be presented in a consistent format of your 

choosing. Also great for code walkthroughs 


and final documentation listings. 
with alt IBM PC, XT. AT, PS 2 


WORK 
v i and compatibles, with 512K 


RAM. Automatically processes all include files 
and pre-processor statements. ANSI-C com- 
patible. Not copy protected. 


C-Clearly *129.* 


Shipping & Handiing USA $5. Canada Mexica $10; Other Cauntnes 
$15: CA Residents add sales tax Visa MasterCard COD accepted 


For orders or information call: 
1-800-648-8266 


V Communications Incorporated 
4320 Stevens Creek Bid. Suite 275-CU 
é Sanfose. CA 95129 
(408) 290-4224 
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Listing 7 


finclude <stdio.h> 
enum node_type (Error, Char, Int, Double, String); 


typedef struct [ 
enum node _type type; 
unton [ 
char ¢3 
int 4; 
double d; 
char *s¢$ 
} value; 
) node; 


void push(node) ; 
node pop(void); 


/* End of File */ 


The stack in Listing 11 can only handle four elements. This 
helps you monitor the progress as elements are pushed and 
popped. Clearly, it would be larger in a real application. Of 
course, the bases of the two stacks are at either end of the 
underlying array and in one stack the stack pointer increments 
as we push and in the other it decrements. Stack overflow is 
detected when the two stack pointers bump into each other. 
Note that it’s OK if both of them point to the same element 
since that last free element is available to which ever stack can 
use it first. 

The two versions of push and pop in Listing 12 are different 
enough that it is not obvious you can write a single version 


SIMPLE TOOLKIT 
FOR X-WINDOWS 


The “unofficial toolkit" for 
programmers who don't have 
time to waste. 


Follows OSF/Motif™ user 
interface style. Full C source 
and interface builder included. 


$229 for 1-2 users, corporate 
site license $458. Call today for 
risk-free 60 day trial. 


STROM SYSTEMS, INC. 


18666 Redmond Way O-2118, Redmond, WA 98052 


Phone (206) 836-2241 
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Listing 8 


main() 
{ 


node n; 


n.value.d = 9.87; 
n.type = Double; 
push(n); 


n.value.s = “some text"; 
n.type = String; 
push(n); 


n.value.i = 123; 
n.type = Int; 
push(n); 


n.value.c 2 ‘A's 
n.type = Char; 
push(n); 


while (n = pop(), n.type {f= Error) { 

switch (n.type) { 

case Char: 
printf("Char = %c\n", n.value.c); 
break; 

case Int: 
printf("Int = %d\n", n.value.i); 
break; 

case Double: 
printf("Double = %f\n", n.value.d); 
break; 

case String: 


printf("String = %s\n", n.value.s); 
break; 


} 


return 0; 


/* End of File */ 


Figure 2 


contains: 
contains: 
contains: 
contains: 
contains: 
lis full 
contains: 
2 is full 
contains: 
1: 15 
contains: 
1: 10 
contains: 
1 is empty 
1: 0 
contains: 
2: 34 
contains: 
2: 12 
contains: 
2 is empty 
2: 0 
contains: 


April'1992 


Listing 9 


finclude <stdio.h> 
#define STACK_SIZE 10 


static node stack(STACK_SIZE]; 
static size_t stack_ptr = 0; 


void push(node n) 


if (stack_ptr == STACK SIZE) 
printf(“Stack is full\n"); 
else 
stack[stack_ptr++] = n; 


) 
node pap(void) 
{ 
static node error_node = {Error, 0}; 
if (stack_ptr == 0) 
return error_node; 
else 


return stack[-stack_ptr]; 


) 


/* End of File */ 


that is both elegant and efficient. The output produced is 


shown in Figure 2. 
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Listing 10 
finclude <stdio.h> 


void pushl (int); 

voi{d push2(int); 

int popl(void); 

int pop2(void); 

void dump_stack(void); 


main() 


dump_stack(); push1(10); 


)s 
dump_stack(); push2(12); 


dump_stack(); push1(15); 

dump_stack(); push2(34); 

dump_stack(); push1(99); 

dump_stack(); push2(65); 

dump_stack(); printf("stack 1: %d\n", popl()); 
dump_stack(); printf(“stack 1: %d\n", popl()); 
dump_stack(); printf("stack 1: %d\n", popl()); 
dump_stack(); printf("stack 2: %“d\n", pop2()); 
dump_stack(); printf("stack 2: “d\n”, pop2()); 
dump_stack(); printf("stack 2: %d\n", pop2()); 
dump_stack(); 


return 0; 


) 
/* End of File */ 
Note that even after a value is popped from a stack it still 


remains there — only the stack pointer is adjusted. This is ex- 
actly what happens when a C function returns; the values of 
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it’s automatic variables are still on the stack but are outside 
the bounds of the newly adjusted stack pointer. They remain 
intact until that part of the stack is overwritten for some other 
purpose. 0 


Listing 11 
finclude <stdio.h> 
#define STACK_SIZE 4 
static int stack[STACK_SIZE]; 


static size_t stack_ptrl = 0; 
static size_t stack_ptr2 = STACK_SIZE - 1; 


/* End of File */ 


Listing 12 


void pushl(int value) 
{ 


if (stack_ptrl > stack_ptr2) 
printf("Stack 1 is full\n"); 
else 
stack[stack_ptrl++] = value; 


} 
void push2(int value) 


if (stack_ptrl > stack_ptr2) 
printf("Stack 2 is full\n"); 
else 
stack[stack_ptr2-] = value; 
} 


int popl(void) 
if (stack_ptrl == 0) { 
printf("Stack 1 is empty\n"); 
return 0; 


} 


return stack[~stack_ptr1]; 


} 
int pop2(void) 
if (stack_ptr2 == STACK_SIZE - 1) { 
printf("Stack 2 is empty\n"); 
return 0; 


} 


return stack[+tstack_ptr2]; 


} 
void dump_stack(void) 
int i; 
printf("Stack contains: “); 
for (i = 0; i < STACK_SIZE; ++i) 
printf ("%4d", stack[i]); 
printf("\tspl = %lu, sp2 = %Tu\n", 


(unsigned long)stack_ptr1, (unsigned 
long) stack_ptr2); 
} 


/* End of File */ 


April 1992 


Book Review 


C Express: 250+ Ready-To-Run 


Assembly-Language Routines 


for Turbo C, Microsoft C, and QuickC 


C Express: 250+ Ready-To-Run 
Assembly-Language Routines for 
Turbo C, Microsoft C and QuickC 


Robert Jourdain 
Brady Books, 1989 
ISBN 0-13-933185-9 


Reviewed by Stephen Patten 


C Express: 250+ Ready-To-Run Assembly-Language Routines 
for Turbo C, Microsoft C and QuickC, a book and accompany- 
ing diskettes, was written (both the assembly source code and 
text) by Robert Jourdain and published by Brady Books, a 
division of Simon & Schuster, Inc. The copy I reviewed was 
dated 1989. 


Companion Diskettes 


Two 5.25" diskettes accompany the 412-page book. One 
diskette contains the eight library files which house the 250 
plus routines in object code form along with eight parallel 
header files for function prototyping. The other diskette con- 
tains the assembly language source of the routines in com- 
pressed form. (You can exchange the 5.25" disks for 3.5"). 

You install the libraries and header files on a hard drive by 
a simple copy, and then call routines as you would any C func- 
tion inside source code. A global variable is also set which is 
used by the compiler to configure the correct memory model. 


Book Contents 


Chapter 1 provides a short introduction to using the library. 
Chapters 2-9 document the library files included on the com- 
panion disk. Chapter 10 includes a discussion on writing your 
own assembly subroutines to link with C programs. This is fol- 
lowed by indices of general topics, the routines, and their ob- 
ject files. 

The routines or functions are documented pretty much as 
you would expect, each described in terms of its purpose, 
parameters, globals required, kinds of errors checked, and 
relevant peculiarities. Examples of calls are also amply 
provided. 

The book also presents background information on groups 
of routines. For example, functions that implement expanded 
memory are preceded by a description of the LIM specifica- 
tion, not in great detail, but enough for the programmer to 
understand what the routines do and why. 
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Interestingly, video routines which can be implemented in 
cither ROM BIOS or memory-mapped form are presented 
both ways, with the ROM BIOS routines suffixed with an un- 
derscore and lower case b. Depending upon the application, 
the programmer can choose between speed and portability. 


Overview of Functions 


The cquipment configuration routines access the usual 
details of installed hardware and are only notable in that they 
climinate the bit manipulations required when using the com- 
piler library to extract the same information. 

The memory management routines test for extended and 
expanded memory, and allow programming of expanded 
memory applications. Pages can be allocated, switched and 
deallocated, and data exchanged between expanded memory 
and RAM quickly and easily. This can be a real plus to a C 
programmer restricted by the one megabyte limitation of the 
MS-DOS environment. 

C Express routines, like hex_to_char, hex_to_int, bi- 
nary_to_char, and binary_to_int, interpret such strings as 
numbers, producing values which can then be entered as 
numeric data in C programs. Combined with existing stdlib.h 


Learn C++, OOP, and X from 


Best-Selling Author Naba Barkakati 


Object-Oriented Programming in C++ 
A practical guide that explains the basic concepts of 

object-oriented programming (OOP) and shows how to 
apply OOP techniques in C++. Includes examples of DOS 
and Windows applications in C++. Get the code ona 3.5" 
DOS disk to learn C++ and OOP. Ideal for Borland C++. 
Book (695 pg) plus disk $49.95 Book or Disk only $29.95 


X Window System Programming 
Tutorial/reference for C programmers learning to program 
X with Xlib and the Motif widgets. Code available on a 
3.5" diskette in MS-DOS or UNIX tar format. 

Book (782 pg) plus disk $49.95 Book or Disk only $29.95 


Both books published in 1991 by SAMS, Carmel, IN. 
VISA/MasterCard Orders Accepted 
Call or send payment (money order or check in U.S. 
Dollars, or VISA/MasterCard account information) to: 


LN SOFTWARE, INC. 


2005 Aventurine Way, Silver Spring, MD 20904 USA 
Voice: (703) 284-2009 FAX: (703) 276-0759 


| Shipping : $3 per book in U.S., $6 per book outside U.S. Maryland 
resident, add sales tax. Written orders, include VISA/MC expiration date. 
+ Request 198 on Reader Service Card + 


Page 96 — The C Users Journal 


utility functions, like itoa, they can also be used to convert 
binary to hex, or vice versa, a nice library facility. 

There are string manipulation routines to add or delete 
characters to or from strings, change string characters, and 
perform various substring operations. There are also keyboard 
routines that provide for fast operating system calls to check, 
read, clear, wait on and change characters, and scan codes in 
the keyboard buffer. 

filter_in, for example, captures the next keystroke in the 
buffer then looks for the same character in a predefined table. 
If found, the keystroke is accepted; otherwise, it’s rejected. A 
related routine, filter_out, does the opposite, rejecting a 
character found in the table. 

key_pause allows a key to act like an ON-OFF switch. Hold 
it down and, let’s say, a help screen appears. Release it, and 
the help screen disappears. This can replace long and compli- 
cated if and switch statements with cleaner, faster code. 

Mouse routines, based on Microsoft’s driver, position the 
mouse cursor, turn it on and off, capture a button press, report 
mouse positioning and control mouse motion to cursor move- 
ment. With pixel_ratio, you can set the exact movement 
ratio between the mouse and its cursor motion. With 
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define_graphics_cursor, you can set the precise pixel or “hot 
spot” inside the pattern of pixels that fall under the cursor dis- 
play. 

Screen control routines set the video adapter, position the 
cursor, sct mono or color attributes, and control the writing of 
strings to the screen. For example, clear_blink changes the 7 
bit in the attribute byte so that it controls the intensity of back- 
ground colors rather than blinking, effectively doubling back- 
ground colors in CGA text mode. set_blink restores the bit 
to its original interpretation. 

display and display_b, unlike printf, are passed argu- 
ments to both position a string before displaying, and display 
with an attribute. 

The graphics in C Express are Jimited to the CGA text 
mode. Like the screen control routines, there are both 
memory-mapped and BIOS versions. They draw the usual as- 
sprtment of graphics figures as well as scroll sections of the 
screen either vertically or horizontally. Written in assembly, 
they run very fast. 

The file routines are built around a data structure called 
tree_array which holds directory names and pointers to sub- 
directories. The routines work with the structure displaying a 
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directory tree or searching through the tree for a file. It’s a 
little tricky going at first, but the book makes it all pretty clear. 

Finally, a variety of printer output services are included. 
They simplify sending output to the printer inside a C pro- 
gram, do a certain amount of printer formatting, interpret em- 
bedded control codes in strings and implement the BIOS print 
screen function. wrap line formats a string for printing in 
word wrapped form, while justify_line formats a string in 
right-justified, word wrapped form. The prtsc routine per- 
forms a screen dump, sending both text and graphics images to 
the printer. 

In conclusion, the C Express package provides a collection 
of object code files and routines for calling within a C pro- 
gram. The routines are not unique in terms of their 
functionality but are a fairly standard collection that can be 
found in other off the shelf libraries. They are easy to set up 
and use, and they run fast. I was unable to find any bugs. The 
book provides good, well-organized documentation, and 
guidance for using the library files. 

Particularly for new C programmers, the package would 
very likely make an excellent starter kit and base from which 
to build their own language libraries. 0 
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Sydney S. Weinstein 


It’s Back! 


It’s official. Paul Vixie has indeed taken over the modera- 
tion of comp.sources.unix. He also has the assistance of two 
co-moderators, Mike Stump and Nick Lai, to help him prevent 
the kind of backlog that occurred recently. Submissions to the 
news group, and comments to the moderators should be sent 
to unix-sources-moderator@pa.dec.com or decwrllunix- 
sources-moderator. The queue has 
been cleared, and the backlog posted. 
However, it includes over six 
megabytes of sources in 37 separate 
postings. Here are just the highlights. 

The first posting of the “new era” 
was chop from George Sicherman 
<gls@hrmso.att.com>. chop extracts 
selected fields or columns of lines 
from the specified files or standard 
input, and writes them to standard 
output. It is similar to cut, a tool from 
the UNIX Documenters Workbench. 
chop allows for variable field 
separators and for output of the fields 
in the order specified on the command 
line. chop is Volume 25, Issue 1. 

Victor Abell <abe@mace.cc.pur- 
due.edu> has obsoleted two of his 
older postings, ofiles and fstat, with 
a new version of lsof. LiSt Open Files 
displays the names of files opened by 
processes on selected UNIX systems. 
This new version in Volume 25, Issue 
2, supports any file system based on 
the SunOS vnode model. This includes 
SunOS, AIX, HP-UX, NeXTStep, Dynix and some others. It 
understands most vnode extensions, NFS connections, FIFOs, 
multiplexed files, and UNIX and INET sockets. 

Abell having obsoleted ofiles, Robert Ehrlich 
<ehrlich@margaux.inria.fr> then went and reworked the 
original ofiles and released ofiles2 for Volume 25, Issue 72. 


eae | ES 


This new version is more portable, but is still designed for 
BSD derived UNIX systems. As with lsof, ofiles2 displays 
the names of files that are being used by processes. 

A major update to the “Threaded RN” Newsreader was is- 
sued by Wayne Davison <davison@boreland.com> for Volume 
25, Issues 4-16. TRN is based on RN 4.4, and the posting in- 
cludes both RN and the changes to 
make TRN from RN. TRN uses the 
References header to build a discus- 
sion thread out of the news group. 
The articles are then presented in dis- 
cussion thread order. 

One of the long promised postings, 
held in the queue for ages, is ease 
v3.5. ease is a decompiler that con- 
verts sendmail.cf into a language that 
is much easier to understand, and 
then allows editing of that inter- 
mediate language. It also includes a 
compiler to convert the ease language 
back into a sendmail.cf file. Con- 
sidering how unreadable sendmail.cf 
files are, anything is an improvement. 
However, ease is a vast improvement. 
Bruce Barnett <bar- 
nett@crdgwl.ge.com> contributed 
ease for Volume 25 Issues 17-22. 

Wen-King Su <wen- 
king@vlsi.cs.caltech.edu> co n- 
tributed fsp, one of the more interest- 
ing postings. It consists of a set of 
programs that implement a public-ac- 
cess archive server similar to anonymous-ftp. While the actual 
code is probably not of much use to most CUJ subscribers, the 
concept and the implementation of that concept are a very 
well thought out lesson in client/server computing. It shows the 
tradeoffs between multiple servers, and a single stateless serv- 
er. FSP was posted as Volume 25, Issues 24-26. 
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Several of the newer UNIX shells provide interactive com- 
mand line editing. The ile program from Robert C. Pendleton 
<bobpChal. com> provides this same capability for any program. 
It runs the program as a subprocess so it does not need to 
modify the program, nor does it even need the source of the 
program it is servicing. It cannot provide a command history 
from program to program however. ile is Volume 25, Issue 
29. 

One of the nicer capabilities of the Bitnet sites is the 
listserv program provided to automate maintenance of mail- 
ing lists. Anastasios Kotsikonas <tasos@cs.bu.edu> has 
provided similar capabilities in his listserv v5.31 package 
posted in Volume 25, Issues 35-40. listserv provides support 
for list, list-owner, and list-request aliases for the mail- 
ing list and provides the back end programs for archives, 
moderated lists, peer lists, automated subscription, changes of 
address, and canceling of subscriptions. 

I get spoiled by running on a bit-mapped screen with a 
good windowing system. Just writing this column I have several 
windows open, one for the column, one for the list of files to 
write about, and one containing the file I am reviewing. For 
those stuck on standard ASCII terminals Juergen Weigert 
<jnweiger@imnd4. informatik.uni-erlangen.de> has released 
version 3 of his multi-session package, screen3, for Volume 

25, Issues 41-48. It allows several different virtual screens on a 
single terminal using a short “hot key” sequence to switch be- 
tween the sessions. 

One of the more popular UNIX shells for interactive use 
has been csh, the c-shell. Over the years, many interactive ex- 
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tensions to csh were published as tcsh. These extensions used 
to require the source of csh as the base for the patches. Now 
with version 6, the full source of tcsh can be released. tcsh is 
a “kitchen sink” shell. It supports command line editing, com- 
mand and file name completion, lists, manual lookup, job con- 
trol, and has been ported to many different UNIX systems. 
For those that prefer csh to ksh, then tcsh will give you all the 
benefits of ksh with the csh syntax. The newest version, 6.01, 
was contributed by Christos Zoulas <christosG@ee.cor- 
nell, edu> for Volume 25, Issues 54-71. 

Another major update is the latest version of the Revision 
Control System. RCS v5.6, which is a very flexible source code 
librarian not only supports source files, but also can track 
changes to binary files. RCS v5.6 was contributed by Adam 
Hammer <hanmer@cs.purdue.edu> for Volume 25, Issues 77- 
87. New in v5.6 are changes to fix security problems, efficiency 
changes for retrieving older versions, and the following of sym- 
bolic links instead of breaking them, and more reliable lock 
files under NFS. 

Emmet Gray <fthood!egray@uxc.cso.uiuc.edu> has up- 
dated his mtools package to version 2.0.5. mtools allows 
UNIX systems read, write, and manipulate files on an MS- 
DOS filesystem (typically a diskette). It emulates the com- 
mands ATTRIB, CD, COPY, DEL/ERASE, DIR, FORMAT, LABEL, 
MD/MKDIR, RD/RMDIR, COPY, REN/RENAME, TYPE, and COPY. The 
FORMAT command only adds the MS-DOS file system to the 
diskette. It depends on the UNIX low-level format routines to 
actually low level format the diskette. mtools2 was posted in 
Volume 25, Issues 97-99. Volume 25, Issue 103 is a set of 
patches to mtools 2.0.5 from Henry van Cleef <vancleef@net- 
com.netcom.com> to support XENIX 286 systems. There were 
portability problems in the original release in regards to as- 
suming that ints are at least 32 bits long. In XENIX 286, an 
int is 16 bits. 

Recent patches appearing in comp. sources.unix include: 

psroff had patches 5, 6, and 7 posted as Volume 25, Issues 
32, 33, and 104. psroff allows both older C/A/T troffs and 
the newer di-troffs to work with Postscript printers and with 
HP Laserjet printers. Patch 5 is minor fixes mostly for com- 
pilation on 80286 style machines. Patch 6 is very important as 
several major features were broken and fixed by this patch. 
Patch 7 is fixes for groff/di-troff users using HP laserjets. 

pathalias, the USENET map routing program, had patch 
10 released by Peter Honeyman <honey@citi.umich.edu> as 
Volume 25, Issue 89. This is purely a bug fix patch and it is 
very small, but since so much depends on pathalias, I though 
it worth mentioning. 


No Reviews 


The status postings show several projects in the re-review 
stage, but nothing appeared in comp.sources.reviewed over 
the past two months. Now that comp.sources.unix is back, 
this is not unexpected. 


misc Tries an Experiment 


Kent Landfield, the moderator of comp. sources.misc tried 
an experiment this time. He took a very large posting, made a 
tar file of it, and then compressed the tar file. He then uuen- 
coded the compressed tar file and posted that. Even posted 
that way it was 42 parts (plus part 00 with the text on what the 
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posting is and how to convert it back to a tor filc). If posted as 
the normal shar format it would have been over 140 parts, 
probably the largest single posting ever tried. Reviews of this 
method were mixed, with a large amount of complaints on 
how it is harder to determine what is there, and to sort and 
deal with it, but I had no problems saving the files, running my 
concatenation script and feeding that to uudecode to convert 
the ASCII back to binary. It then uncompressed cleanly and 
produced a 7.5MB tar file. 

And what was this grand experiment... pp v6.0, a Mail 
Transfer Agent (MTA). pp is designed for high volume mes- 
Sage switching, protocol conversion, and format conversion. pp 
supports X.400, RFC-822, and RFC-1148bis conversion be- 
tween RFC-822 and X.400. PP is designed as a replacement 
for MMDF or sendmail. pp speaks X.400 (1984 and 1988), 
SMTP, JNT, UUCP, DECNET Mail-11, 
X.500, alias files, RFC-822 local delivery, 
and Fax Internetworking. No User Agents 
are provided, but a line oriented and an 
X-Window based management console 
program are provided. pp v6.0 was con- 
tributed by Steve Hardcastle-Kille 
<S.kille@cs.ucl.ac.uk> for Volume 27, 
Issues 24-66. 

The shadow log-in suite for UNIX 
systems was rereleased by John F. 
Haugh II <jfg@rpp386.cactus.org> for 
Volume 26, Issues 54-64. New in release 
3 is support for SVR4 style maintenance 
utilities and the grouping of the code 
into libraries to make maintenance 
easier. This suite provides shadow log- 
in/password management to many 
UNIX systems that do not yet have such 
support natively. One file was left out of 
the distribution and was posted as patch 
1 in Volume 26, Issue 75. 

Robert Davies <robert@an. dsir.govt.nz> 
contributed a new version of his C++ 
matrix package for Volume 26, Issues 
87-91. newmat04 supports matrix, upper 
and lower triangle, diagonal and sym- 
metric matrices, row and column vectors 
and the element type float/double. 
Operators include *, +, -, inverse, 
transpose, submatrix, determinant, 
decomposition, triangularization, eigen- 
values, sorting and fast Fourier trans- 
forms. It is intended for matrices in the 
size range 4x4 to 90x90. 

Have an HP Laserjet with the Pacific 
Data Systems 25-in-One font cartridge? 
If so, Bill Walker’s <bkw@uecok.e- 
cok. edu> wroff is what you need. It is a 
text formatter in the spirit of nroff, but 
designed specifically for this combina- 
tion of hardware. wroff runs on UNIX, 
XENIX, MS-DOS and CPM-68K. It 
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docs kerning and some other troff like items as well. wroff is 
Volume 26, Issues 97-101. 

Ted Campbell <tcomp@hercules.acpub.duke.edu> con- 
tributed sfs the space flight simulator for IBM PC’s with 
EGA or VGA, UNIX- PC’s with MGR or UNIX with X11. A 
21-part posting in Volume 27, Issues 1-21, sfs offers a 
graphics-based real-time animated simulation of orbital flight. 
You can simulate a complete range of orbital parameters and 
can also simulate multiple planets in a solar system. A par- 
ticularly full map is given of the earth and can be displayed as 
viewed from the orbiting spacecraft, as a ground track map, or 
as a distance perspective in which the orbital track can be 
seen. 


A compatible regex (regular expression) package without 
any licensing restrictions was contributed by Tatu Ylonen 
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<ylo@ngs. fi> for Volume 27, Issue 23. It is fully compatible 
with the GNU regex library and can handle arbitrary data in- 
cluding binary patterns. It also can compile and run on 16-bit 
machines such as MS-DOS. 

Those interested in genealogical research may want to get 
Steve Murphy’s <murf@oakhill.sps.mot.com> gcom from 
Volume 21, Issues 72-78. gcom reads in GEDCOM format files 
containing genealogical data and merges them, utilizing not 
only name and date match heuristics, but familial ties as well. 

In my February column, I mentioned Archie, the service 
that keeps track of which sites archive which data. Brendan 
Kehoe <brendan@cs.widener.edu> has updated his archie 
client in Volume 27, Issues 79-84. Version 1.3 of archie is his 
Prospero client for the archte service. Note, using this client 
requires TCP/IP access to an Archie server, which means you 
must be on an Internet. 

* Last on the new release front is the latest release of dmake. 
Version 3.8 replaces version 3.7 and hopefully addresses all 
the little obscure bugs and features that remained. Dennis 
Vadura <dvadura@plg.waterloo.edu> has provided this ver- 
sion of the make utility. This package is the extended make ala 

BSD 4.4 release including many more features than the tradi- 
tional versions. It includes support for UNIX, XENIX, MS- 
DOS, OS/2, and Atari-ST TOS. dmake 3.8 is Volume 27, Issues 
101-142. 

On the patch front, patch 9 was issued for parseargs in 
Volume 26, Issues 65 and 66 by Brad Appleton 
<brad@ssd.csd.harris.com>. parseargs provides a set of 
functions to parse command-line arguments. It can do much 


VA 


Use the Universal Graphics Language or B 
G-BASE to develop graphics applica- 
tions much faster and easier than you 
can using graphics libraries. There are 
only 25 commands to leam. Batch print 
custom designed graphs using data 
from any database and create drawings 
ten times faster than you can using CAD! 


M-TECH Development Corporation 
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more than the getopt variety of parser. Patch 9 is mostly bug 
fixes and was followed by patch 10 in Volume 26, Issue 116 for 
a bit more cleanup. 

qbatch from Alan Saunders <tharr!alan> had its patch 2 
posted for Volume 26, Issue 70 and patch 3 posted in Issue 85. 
Again, these were bug fix releases. 

The KSH lookalike, pdksh, posted by Simon Gerraty 
<sjg@zen.void.oz.au> was updated to patch 1 in Volume 26, 
Issues 71 and 72. The build process was cleaned up and some 
portability issues were addresses. 

The tin threaded newsreader had patches 6 and 7 posted by 
Tain Lea <stevax!/iain> in Volume 26, Issues 76-82. New are 
support for Minix 386, more -M options for From lines, unread 
articles, and scrolling, plus some bug fixes. Patch 6 was in five 
parts and patch 7 in two parts. 

PBMPLUS the multi-format image manipulation toolset 
was also updated to fix some bugs and to add several new 
programs. Jef Poskanzer <jef@well.sf.ca.us> provided patch 
10 in Volume 26, Issues 106-110. New are pgmcrater, 
ppmforge, ppmtoacad, and sldtoppm. 


Alternative Games 


Two different versions of a “get the money game” called 
sokoban were contributed by two different authors. Kevin 
Solie <kevins@ms.uky.edu> contributed his xsokoban for 
Volume 13, Issues 1-2. This X-based game is a very incomplete 
implementation of an idea from a similar PC game. 

The other version, xsokoban2, is from Joseph Traub 
<jtlo+@andrew.cmu.edu> and was released in Volume 13, Is- 
sues 13-15. It provides a slightly different user interface than 
Kevin’s version, but is essentially the same game. 

Volume 13, Issue 3 provides dr_mario from Scott Noecker 
<noecker@seq.uncwil.edu>. This is a one-player lookalike 
version of Dr. Mario, a popular game for Nintendo that has 
nothing to do with the Mario Brothers series. It uses the 
standard keyboard and curses for the display driver. 

A complete revision of the WCST Nethack spoilers file up- 
dating it to version 7 was contributed for Volume 13, Issues 
4-9 by Paul Waterman <wheaton!water>. A complete refor- 
matting has been done to make the information easier to use, 
and of course, more changes and sections have been added. 

A connect-five-in-a-row-game, xmake5 was contributed by 
Chih-Hung Hsieh <hsiehch@spunky.cs.nyu.edu> for Volume 
13, Issues 10-12. This game, written in C++ provides both a 
curses and an X-Window interface. The X version uses the 
athena widgets library. 

For those with multi-user networks, a multi-player net- 
worked bridge game was contributed by Matthew Clegg 
<mclegg@cs.ucsd.edu>. okbridge, Volume 13, Issues 16-23, is 
a computer mediated bridge game that allows four players to 
participate in a game of rubber or duplicate bridge. The pro- 
gram handles dealing, scoring and communication of bids and 
plays. Issue 23 is a patch to fix a small problem in one of the 
distribution files. 


Previews from alt.sources 


Its been a quiet two months in alt.sources, only 4MB 
worth of notable postings (that or I am being more selective in 
what I consider notable). The most notable posting is a release 
of a uwucp work-alike package from Ian Lance Taylor 
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<ian@airs.com>. taylor-uucp v1.01 was posted on November 
24, 1991 in 18 parts. It is a complete replacement for HDB 
style UUCP. It supports V2 style configuration (L.sys, L- 
devices) and BNU (aka HDB) style configuration files (Systems, 
Devices). It is a complete system, except for the fancy main- 
tenance shell scripts and uusched (the latter is in the works). 

Curt Mayer <hoptoad!curt> posted his disassembler for 
Z80/Z280 CP/M .COM files on November 27, 1991. The out- 
put is capable of being assembled and can detect code sequen- 
ces by tracing jump targets. 

Along with the CP/M disassembler, D’Arcy J. M. Cain 
<druididarcy> posted on December 19, 1991 in three parts 
his Z80 CP/M emulator for UNIX. Most of the Z80 instruc- 
tion set is implemented, except for the I/O section. The 
emulator also uses the UNIX shell commands to simulate 
some of the CP/M commands and uses the UNIX file system 
for drives. All I/O must go via the BDOS or BIOS as IN and 
OUT opcodes are not fully implemented. 

On the opposite front, Quinn Jenson <jen- 
senq@qcj.icon.com> posted a DSP56001 assembler on 
November 29, 1991 in four parts. The syntax was intended to 
be compatible with Motorola’s syntax, but without the docs he 
could only guess. It does allow for UNIX based DSP code 
development for those not lucky enough to have a NeXT. 

peal, the postscript calendar program has been updated to 
Version 4.3 by Joseph Brownlee <jbr0@cbnews.cb.att.com> 
on December 16, 1991 in seven parts. pcal allows for creation 


of personal calendars. New in 4.3 are generation of UNIX 
calendar files, move the previous and following month boxes 
around on the page, allow notes in any empty day box, change 
both note font and size via command line options, addition of 
the nearest keyword as in “workday nearest every 10th”, plus 
about a page more worth of additions (something had to fill 
the 13000 lines of the posting). 

Mayan Moudgill <noudgill@cs.cornell,edu> has posted 
his C++ socket library that adds UNIX and INET sockets to 
the iostreams functions. It was posted in late December, and 
then an updated posting was made on January 8, 1992 in two 
parts. Supported are convenient connection setup routines, use 
of the usual << & >> operators for i/o, support for out of band 
message transmission and reception, and an easy method of 
Specifying per socket SIGIO, SIGURG and SIGPIPE hand- 
lers. Also include is an interface to the select system. 

A gateway between the UNIX and the Citadel style BBS 
was posted on December 24, 1991 in four parts by Ken Mac- 
Leod <unidel@bitsko.slc.ut.us>. uccico implements the 
Citadel BBS networking for a UNIX system much like uucico 
does for UUCP. It handles USENET news and RFC822 mail 
conversion. 

A large posting was mixview, posted by Robert Lau but 
written by Douglas Scott <doug@woof.columbia.edu> in 11 
parts on January 12, 1992. It is an X-Window program that 
allows for editing sound files. It supports any BSD style system 
that has sound capabilities, such as Sun’s and NeXT’s. 0 


Calendar of Events 


April 


1-3 Eleventh IEEE International Phoenix Conference on Computers and Com- 
munications, Scottsdale, Arizona. Contact IEEE IPCCC-'92, P.O. Box 8950, 
Scottsdale, AZ 85252, (602) 234-4477. 


6-10 LATIN '92, Internation Symposium of Latin American Theoretical Infor- 
matics, Sio Paulo, Brazil. Sponsored by ACM. Contact Univerisdade de Sao 
Paulo, Instituto de Matematica ¢ Estatisticas, Caiza Postal 20570; 55-11-813-9499. 


27-30 XWorld, The X Info Xchange, New York. Sponsored by the X Journal. 
Contact SIGS Publicatons, 588 Broadway, Suite 604, New York, NY 10012, 
(212) 274-0646. 


27-May 1 USE inc. Spring Conference, San Francisco. Contact USE, inc., P.O. 
Box 461, Bladensburg, MD 20710, (301) 699-9336. 


30-May 2 Independent Computer Consultants Association 15th Annual National 
Conference, St. Louis, MO. Contact ICCA at (800) GET-ICCA or (314) 997-4633. 


May 


5-7 European Direct Marketing Conference, Brussels. Contact European Direct 
Marketing Association, 34, rue du gouvernement provisoire, B-1000 Brussels, 
32-2-217-63-09. 


June 
1-4 Object Expo, New York. Sponsored by SIGS Publications. Call (212) 274-9135. 
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8-12 C Plus C++...in Action, London. Sponsored by Boston University. Con- 
tact Boston University, Corporate Education Center, 72 Tyng Road, 
Tyngsboro, MA 01879, (508) 649-9731. 


10-12 International Conference on Intelligent Tutoring Systems, Montreal. Spon- 
sored by ACM. Contact University of Montreal, 2900 boul. Edouard- 
Montpetit, Dept I.R.O. Montreal, Quebec H3T 134, (514) 343-7019. 


July 


12-17 AAAI-92, San Jose, CA. Tenth National Conference on Artificial Intel- 
ligence. Contact AAAI-92, 445 Burgess Drive, Menlo Park, CA 94025, (415) 
328-3123. 


14-17 Object Expo Europe, London. Sponsored by SIGS Publications. Call 
(212) 274-9135. 


20-24 Logic at Tver 92, Tver, USSR. Sponsored by ACM. Contact University 
of Tver, 33 Zhelyahova Street, Tver 170013 USSR. 


August 


10-13 C++ Technical Conference, Portland, OR. Fifth annual C++ con- 
ference sponsored by USENIX. Contact USENIX Conference Office, 22672 
Lambert St, Ste. 613, El Toro, CA 92630. 


24-27 18th Intemational Conference on Very Large Data Bases, Vancouver, BC. 
Sponsored by ACM. Contact University of Alberta, 615 General Services 
Bldg., Edmonton, Alberta T6G 2HI Canada, (403) 492-4589. 
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Ken Pugh 


Calling Functions from Within a Function 


Q! work with ANSI-C and I have a general problem. How 
is it possible to call one function with a variable num- 
ber/types of arguments inside a second function with variable 
number/types of arguments, with the same arguments I called 
the second function? 

For example, I have three functions with a variable number 
and variable type of arguments (myfunctionl, myfunction2, 
myfunction3 shown in Listing 1). I want to call the functions 
myfunctionl and myfunction2 from 
inside myfunction3, with the same ar- 
guments I called myfunction3. Is there 
an easy way to do that? 

Thank you very much for your 
answer. 

Willi Fleischer 
Moerfelden, Germany 


The error involves the difference 

between a variable parameter list 
and a parameter list containing a value 
of type va_list. When you pass 
parameters to a function, the values of 
those parameters are pushed onto the 
stack. Usually the first or second 
parameter to a variable parameter 
function indicates directly (with a 
count) or indirectly (as with format 
specifiers) how many values have been 
passed. 

The printf and fprintf functions 
expect to see the values on the stack. 
Each value has an address (its position 
on the stack). The vfprintf function 
expects its third parameter will be the 
address of the first value of a set of parameters on the stack. It 
then uses this address to retrieve those parameters. To use 
each parameter, it needs to know the type of the value. That 
information it gets from the format list specifiers, just like 
printf and fprintf. The type of the parameter is also used to 
find the next parameter. 


Perhaps it might be instructive to look at typical definitions 
for these macros. Those in Listing 2 are from Microsoft C. 

Variables of type va_list are actually addresses. va_start 
puts into the first argument the address of the first variable 
parameter. va_org increments the first argument (ap) by the 
sizeof the type which is passed as the second argument (ft), as 
well as yielding a value of that type. 

How does vfprintf get to a value on the stack? Since it 
knows the type of argument (from the 
format list), it uses the va_arg macro 
with the appropriate type. 

Your my_functtonl and my_func- 
tion2 require a list of values to be 
passed to them. When you used the 
va_start macro in my_function3, you 
retrieved the address of the first vari- 
able parameter that was passed to 
my_function3. You then passed that 
address to my_functionl and 
my_function2 and they produced gar- 
bage. You need to rewrite my_func- 
tionl and my_function2 such that 
they expect an address (i.e. type 
va_list). Listing 3 shows how they 
should look. 


I’ve been programming in C for 

about two years now and have 
not seen anything in the literature 
about my question. The company I 
work for does quick and dirty produc- 
tion programming. We are in the 
process of moving from PL/I to C. 
The programming involves sequential 
processing of mostly fixed fielded files. In PL/I we read the file 
into an input buffer and use the string function to load it into 
a structure. Listing 4 is an instance. 
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for Programmers and All On C, and was a member on the ANSI C committee. He also does custom C Programming for communica- 
tions, graphics, image databases, and hypertext. His address is 4201 University Dr, Suite 102, Durham, NC 27707. You may fax 
questions for Ken to (919) 489-5239. Ken also receives email at kpugh@dukemvs.ac.duke.edu (Internet). a 
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What this in effect docs is load the structure recin from 
the input buffer inn. There is no corresponding C function for 
loading such a structure and I’ve been trying to develop some- 
thing that will do this. What I’ve come up with is Listing 5. 

While the coding for load_struct works (at least in VAX 
C) I am not convinced this is the best way or even an effective 
way for doing what J desire. I realize the error checking is 
non-existent, but is it correct to assume that a structure of 
character arrays will have contiguous addresses? Is there 
another method used by more experienced programmers? I 
need something that I can put into a library that is very 
generic. How would you tackle this problem? 

Tom Crosman 
Brooklyn Park, MN 


On some machines individual fields in a structure do have 

packing bytes between them to align them to word boun- 
daries, giving them contiguous addresses. Records which con- 
sist of character only (such as your example) tend not to have 
packing bytes. 

Your method in general is fine. Since you asked for my 
solution, I’ve given it in Listing 6. Let me explain the modifica- 
tions that I’ve made. The first is that one should usually never 
declare a variable in the same statement that declares the 
structure template. Anyone who wishes to use that template 
gets stuck with that extra variable. Second, I used an array of 
sizes for each of the fields. These could actually be picked up 
using the sizeof operator. As another alternative, one could 
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Image-based applications can 
be developed in MSC, QuickC, 
and Turbo C environments. 


New Sweden foe 
\ 


#define the size of each ficld and use those in the initializa- 
tion list. 

] prefer using an array for the sizes instead of passing them 
in the parameter list. The declaration can be close to the struc- 
ture template. Any changes in order or size of the fields can be 
simply coordinated. Using an array to pass the sizes also 


Listing 1 


finclude <stdio.h> 
finclude <stdlib.h> 
finclude <stdarg.h> 


void myfunctionl(char *format, ...) 
( 


va_list arg ptr; 

va_start(arg ptr, format); 
vfprintf(stdout, format,arg_ptr); 
va_end(arg ptr); 


void myfunction2(char *format, ...) 


FILE *fp; 

va_list arg ptr; 

fp = fopen(*TEST.DAT","at"); 
va_start(arg ptr, format); 
vfprintf(fp,format,arg ptr); 
va_end(arg ptr); 

fclose(fp); 


void myfunction3(char *format, ...) 
va_list arg ptr; 
va_list arg ptr2; 
va_start(arg ptr, format); 
myfunctionl(format,arg ptr1) H 


/* here I want to use the arguments of myfunction3(), 
va_end(arg ptrl); but this code does not work */ 


va_start(arg ptr2, format); 
myfunction2(format,arg_ptr2); 


/* here I want to use the arguments of myfunction3(), 

va_end(arg_ ptr2); but this code does not work */ 

} 
int main() 

char msg[]="message"; 

my function1("\n%se%d=%f", msg, 2, 3.0); /* this works 
fine */ 

myfunction2("\nss=%d=%f", msg, 2, 3.0); /* this works 
fine */ 

/* the following call of myfunction3() does not work. 

I want to have the same result, as 


if I call myfunctionl() and myfunction2() isolated */ 


myfunction3("\n%s=%d=%f", msg, 2, 3.0); 
} 


/* End of File */ 


Listing 2 


typedef void *va_ list; 


ddefine va_start(ap,v) ap = (va_list)&v + sizeof(v) 
ddefine va_arg(ap,t) ((t*)(ap += sizeof(t))) [+1] 
fdefine va_end(ap) ap = NULL 

/* End of File */ 


April 1992 


Listing 3 


void myfunctionl_a(char “format, va_list arg_ptr) 


vfprintf(stdout, format,arg ptr); 
} 


void myfunction2_a(char *format, va_list arg ptr) 


FILE *fp; 


fp = fopen("TEST.DAT","at"); 
vfprintf(fp, format,arg ptr); 
fclose(fp); 

} 


void myfunction3(char *format, ... 


va_list arg ptri; 
va_list arg ptr2; 


va_start(arg ptri, format); 
myfunction2_a(format,arg_ptr1); 
myfunction2_a(format,arg_ptr1); 
va_end(arg_ ptrl); 


} 
/* End of File */ 


Listing 4 
OCL 1 RECIN, 
2 NAME CHAR(30), 
2 ADDRESS CHAR(20), 
2 CITY CHAR(15), 
2 STATE  CHAR(2), 
2 ZIP CHAR(5) 3 


READ FILE (FILIN) INTO (INN); 
STRING(RECIN) = INN; 


/* End of File */ 


Listing 5 
#define MAX 1000 
void load_struct(instruc, instr, ...)3 


[seek main function S helaehahehalel f 


load_struct(instruc, instr, va_alist) 
char *instruc; 
char *instr; 


int k=0; 

int strnglen; 
va_list ap; 
va_start(ap) ; 


while((strnglen = va_arg(ap,int)) != NULL) 
{ 
for(k = 0; k < strnglen-1; k++) 
*instruct+ = *instrt+; 
*instruct+ = 0; 


va_end(ap); 


} 
/* End of File */ 
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Call for Papers | 


The C Users Journal is secking articles on the 
topics below. If you have an idea for a related story, 
or experience that would qualify you especially to 
write on one of these topics, contact The C Users 
Journal editorial staff for Author Guidelines at: 


The C Users Journal 

Attn: Managing Editor 
1601 W. 23rd St., Suite 200 
Lawrence, KS 66046-2743 
(913) 841-1631 


We prefer practical treatments of real program- 
ming problems, or tutorials that make theory or com- 
plex issues more accessible to practicing program- 
mers. Our emphasis is on C and C++ or on tools 
used in conjunction with these languages. 

We pay at rates that are competitive with other na- 
tional technical journals. We believe that our editorial 
assistance is better than most. You don’t have to be a 
professional writer to meet our acceptance criteria, 
but you must have something to say. Again, contact 
the editorial staff for Author Guidelines. 


Graphics 


Proposals due 4/13/92; manuscripts due 5/11/92 

Suggested topics: Writing C or C++ code that 
ports easily among the major GUI environments; use- 
ful graphic classes and libraries; algorithms for draw- 
ing, shading, windowing, scaling, etc. that are efficient 
and/or elegant; techniques for visualizing data; 
manipulating gray-scale and color images. \ 

Overworked topics (require fresh perspective): 
graphic object classes, graphic file reformatters. 


Proposals due 5/4/92; manuscripts due 6/15/92 
Suggested topics: Interfacing C or C++ code to 
any of the popular commercial network packages; 
strategies for implementing simple but robust net- 
work protocols; programming popular ports or multi- 
plexors in C or C++; tutorials on common interface 
protocols, interchange formats; user reports on major 
communications, interchange packages; simple hand- 


shake algorithms; real-life applications of queuing | 


Communications and Networks | 
| 


theory. 


Overworked topics (require fresh perspective): 
UART drivers, kermit protocol. 
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simplifies the function, since it is no 
longer concerned with a variable 
parameter list. 

To show an additional use for the 
array, I included a print function. It re- 
quires most of the same parameters as 
the load function. 

To make the function more generic, 
I added a nul_terminated flag. Some 
programmers do not like using the extra 
character space to hold a terminator in 
each field. The nul, if present, can sig- 
nify the end of a value less than the 
field length. If not present, the field 
length is the size of the field. Though 
this requires a slight bit more coding, it 
does save significant disk space if you 
store thousands of copies of a structure. 

If you were concerned with the pack- 
ing of the fields in either the input 
record or the output structure, then you 
could add an array of field addresses to 
the calls. If that is necessary, I might 
suggest not using a generic function and 
simply hard coding any record conver- 


sions required. At some point the work 
of providing and using a generic inter- 
face exceeds the benefit. 


Reader Feedback 


Coding style 


I notice in your find_moximum func- 
tion that you declare temporary storage 
for the return value. Is there some 
reason this is preferred over just return- 
ing the value directly? This allows the 
simplifications in Listing 7. 

Also in your listings, for the function 
put_line, it seems to me that putchar 
would be preferred to 
printf ("%c",...). It would not have to 
process the format string and convert 
the character before putting it on 
stdout. 

I enjoy your column and comments. 

Edward C. Sarlls, IIT 
Houston, TX 


Listing 6 


struct rec { 
char name(31); 
char address(21); 
char city[16); 
char state([3]; 
char zip[6]; 


» 
static int field_sizes[] = (31, 21, 16, 3, 6); 
* 


Alternatively, this could be written as: 


static int field sizes[] = { 
sizeof(rec.address), 
)s 


id 


sizeof (rec.name), 


fdefine field_count (sizeof(field_sizes)/sizeof(int)); 


main() 


char record_in[MAX] ; 
struct rec record; 


while(fgets(record_inn, MAX, filin) != NULL) 
{ 


load_struct(&record, record_in, field_sizes, 


field count, TRUE); 


print_struct(&record, field sizes, field_count, TRUE); 


} 
} 


print_struct(record, field_sizes, field_count, nul_terminated) 
char *record; /* Record to print */ 
int field_sizes(]; /* Size of fields */ 


int field_count; 


/* Number of fields */ 


int nul_terminated; /* If fields are nul terminated */ 


{ 

int field; 
int length; 
char *pc; 
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Listing 6 — Cont’d 
printf("\n"); 
pe = record; 
for (field = 0; field < field_count; field++) 


{ 

if (nul_terminated) 
printf("%s:",pc); 

else 


( 
length = field_sizes[field]; 
printf("%.*s:", length, pc); 


} 
pe t= field sizes[field]; 
} 


} 


load_struct(record, record_in, field_sizes, field_count, 
nul_terminated) 

char *record; 

char *record_in; 

int field_sizes[]; 

int field_count; 

int nul_terminated; /* If fields out should be nul terminated */ 


{ 

int field; 
int length; 
char *pc; 
char *pc_in; 


pe = record; 
pc_in = record_in; 
for (field = 0; field < field_count; field++) 


{ 
length = field _sizes[field]; 
strncpy(pc, pc_in, length); 
if (nul_terminated) 

{ 


pc(length-1] = '\0'; 
pc_in += length - 1; 
) 


else 

pce_in t= length; 
pe += field sizes[field]; 
} 


} 
/* End of File */ 


Listing 7 
int find_maximum(one, two, three) 
int one, two, three; 


if (one > two) 
if (one > three) 
return one; 
else 
return three; 
if (two > three) 
return two; 
else 
return three; 


eee OF sae 


int find_maximum(one, two, three) 

int one, two, three; /* This could be a macro if you're 
careful about side effects. */ 

return ((one>two)?((one>three) 7one: three) : ((two>three) ?two:three)); 


/* End of File */ 
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Listing 8 
int find_maximum(one, two, three) 
int one, two, three; 


int ret; 
if (one > two) 
{f (one > three) 


ret = one; 
goto end; 


else 


ret = three; 
goto end; 


printf (“find_maximum returning %d", ret); 
return ret; 


/* End of File */ 


I tend to use an automatic variable for the return value 
from a function. That makes it easier to put a printf state- 
ment in the code to print the return value of the function. Or 
if you are a debugger person, it makes it easy to watch the 
value. 

The disadvantage is a slight decrease in speed. If I made it 
a register variable (or if the compiler does so automatically), 
even that should not be a problem. 


New Windows DLLs 


CrystalCOMM/4BC III PLUS for Windows 
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Listing 9 


if (one > three) 


printf("Find maximum returning %d", one); 
return one; 


/* End of File */ 


Listing 10 


void get_low high(int a, int b, int c, int *low, int *high) 


*low = (a<b) 7a: b; 
if (c < *low) *low = c3 
*high = (a> b) 7 a:b; 
if (c > *high) *high = c; 
} 


/* End of File */ 


If you decide to change the return value of the function 
that uses an expression, and then with the local parameter, you 
only have to change the expression in one place. If you have 
debugging output, you need to change it in two. 

I must admit that I have had this style for a long long time. 
In one of my C classes that I taught back in the early ’80s, I 
had a student who insisted that parentheses were required 
around the expression that follows the return statement. It 
turns out that all the examples of return statements he had 
seen had complex expressions around them (as the one in your 
second example). Psychologically the parenthesis were needed 
to surround the expression and “make it one.” That points up 
the other coding style that I use quite often (see Listing 8). I 
state in All on C that having a single return statement with 
gotos is preferable to having multiple return statements. If I 
want to trace the return value, with multiple return state- 
ments, I have to do something like the code shown in Listing 
9. 

If I were using a debugger, there would be several break- 
points to set (assuming the function was long enough that I 
simply didn’t single step through it). 

The difference in the complexity of code between multiple 
returns and multiple gotos (to the end of a function) does not 
seem to be a big issue, at least to me. 

I may get hundreds of letters regarding this seemingly 
idiosyncratic style of programming (or maybe with an adjective 
using only the first two syllables). Before that occurs, I wish to 
make a few caveats regarding it. First, I try to program the 
logic not to require multiple returns/gotos. Hence the original 
listing has neither in it. Second, there should be a single label 
at the end of the function with a standard name (say end), that 
is the Jabel for the goto. If that is the case, then ret = xxx; 
goto end takes on the same meaning as return xxx;. (KP) 


Q: just read your question and answer article entitled 
“Using typedef” in the December 1991 issue of The C 
Users Journal. I am writing in reference to the question regard- 
ing the writing of a function returning the lowest and highest 
integer out of the three integers passed. Listing 10 is my at- 
tempt at answering this question. 
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Listing 11 


#include <stdarg.h> 


int maximum(int count, int first,...)3 
main() 
{ 
int ret; 
ret = maximum(6, 2,3,4,5,9,8); 
printf("Maximum is %d\n", ret); 


int maximum(int count,int first,...) 
{ 
va_list arguments; 
int 1; 
int value; 
int maximum = first; 
va_start(arguments, first); 
for (i = 0; 1 < count - 1; i++) 
{ 
value = va_arg(arguments, int); 
if (value > maximum) 
maximum = value; 


va_end(arguments) ; 
return maximum; 


}) 
/* End of File */ 


With all due respect, I think this approach is more elo- 
quent and less convoluted than the methods offered in List- 
ing 2 (December 1991 issue) and Listing 3 on page 120 
(December 1991 issue) and in Listing 4 on page 122 


We care 
Y about the 
environment 


print 


That’s why we 
with SOY INK. 


The Users Journal” 


PRINTED WITH 


SOY INK 
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Listing 12 
void find_min_max(one, two, three, minimum, maximum) 
int one, two, three; 
int *minimum; 
int *maximum; 


if (one > two) 
*minimum = two; 
else 
*minimum = one; 
1f (three < *minimum) 


*minimum = three; 


1f (one < two) 
*maximum = two; 
else 
*maximum = one; 
{f (three > *maxmium) 
*maximum = three; 


return; 


/* End of File */ 


(December 1991 issue), whether or not you choose to use the 
conditional shorthand. 

I am also puzzled by the fact that you were a member of 
the ANSI C committee and you didn’t use prototypes in your 


code. Did you have a special reason for not prototyping your 
examples? 


SJ. Stern 
Bothell, WA 
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Listing 13 
typedef double SPEED; 
typedef double DISTANCE; 
typedef double TIME; 


SPEED low speed, high_speed; 
DISTANCE short_distance, long distance; 
TIME brief_time, long time; 


/* End of File */ 


Listing 14 


SPEED compute_speed(DISTANCE distance, TIME time); 


/* End of File */ 


Eloquence is in the eye of the beholder. Some people 
ight consider the second part of Listing 7 (from Mr. 
Sarlls letter previously in this column) the most eloquent. I 
don’t particularly prefer any of my Listings 2, 3, or 4. My 
favorite is Listing 5 (from the December 1991 issue, 
reproduced here as Listing 11). It computes the maximum for 
any number of input parameters. The logic in your sample 
matches the logic in that listing. 

I guess I could have arranged the logic in my function as 
shown in Listing 12. It matches your logic and has fewer lines 
than my previous listing. Unless I am going to call a routine a 
few thousand times, I tend to stick with whatever I come up 
with first that works. Also, I usually avoid using the conditional 
expression operator, for the reasons explained in last month’s 
column. 

As far as prototypes, I usually do not include them unless 
they are required by ANSI C or they are essential to the 
answer. The information contained in prototypes is mostly 
redundant. The case of the variable parameter function (as in 
Listing 10) requires one. When I do need prototypes (e.g. for 
C++), I let the compiler or PC-Lint generate a file of them. 

Thank you for your feedback. (KP) 


typedefs and lint 


In my column a few months ago, I answered a question 
regarding typedefs. At the recent C-Forum sponsored by the 
Wang Institute of Boston University, I bumped into Jim Gim- 
pel, the author of PC-Lint. He told me that the latest version 
of PC-Lint has an option for strong typing. This means that it 
can report errors in the use of typedefed variables which the 
compiler would just ignore. For example, given the code in 
Listing 13, the assignment of 


short_distance = high speed; 


is accepted by the compiler without question since both vari- 
ables are declared to be type double, once the typedefs are 
resolved into the underlying types. However PC-Lint can yield 
an error message, if strong typing is turned on. 

As another example, a function declared as shown in Listing 
14 will give a PC-Lint error if it is passed the code in Listing 15. 

There are many options available for strong typing, which 
are all described in the manual. In addition, you can declare 
that particular arrays can only be indexed by variables of par- 
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ALSO AVAILABLE—FirstSQL C EMBEDDED SQL for C 


Listing 15 


low_speed = compute _speed(long time, short distance); 


/* End of File */ 


Listing 16 
/* Vint -index(¢,INDEX,HISTOGRAM) */ 
typedef unsigned int INDEX; 
typedef int HISTOGRAM 
fdefine SIZE (INDEX) 10 
HISTOGRAM my_array([SIZE]; 
INDEX good_index; 
int not_good_ index; 


my_array[good index] = (HISTOGRAM) 5; 
my_array[not_good index] = (HISTOGRAM) 7; 


/* End of File */ 


ticular types. For example, arrays of type HISTOGRAM can only 
be indexed by variables of type INDEX. This would look some- 
thing like Listing 16. 

The not_good_index reference to my_array would yield an 
output error. 

For those who are considering changing to C++ purely for 
its type-checking abilities, I suggest you look at PC-Lint as an 
alternative. (KP) 0 
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Kenji Hino 


Update 


CUG297 Small Prolog 
Henri de Feraudy (FRANCE) has 
released v2.0 of his Small Prolog. The 
new version offers much better debug- 
ging facilities, and a 32-bit executable 
compiled by GCC-386 (CUG359). 


CUG327 Panels for C 

J. Brown (KS) has released v2.3 
update of his shareware window pack- 
age, Panels for C. This version in- 
cludes these new features: OS/2 sup- 
port, Turbo C support, utilizing the 
PATH environment variables to find 
panel definition files, allowing the in- 
clusion of panel definitions in the C 
source program, Interactive Panel 
Design (IPD) utility. 


CUG351 UltraWin 

Kevin L. Huck (MO) has released 
v2.10 of his shareware, Ultrawin. This 
new version includes new features: un- 
limited overlapping windows, back- 
ground printing, PC timer control, 
mouse and graphic support, and en- 
hanced data entry capabilities. Also in- 
cluded are a hypertext help engine and 
and EGA/VGA font editor. Also 
released is InTUItion 1.10, a textual 
user-interface library that includes an 
interface contruction program that al- 


New Releases- 
a | 1 \ 1 


lows UltraWin users to interactively 
create dialog boxes, menus, pick lists, 
forms and more using a mouse. 
Source code can be automatically 
generated to perform processing on 
each item, saving hours of tedious 
hand coding and debugging. 


New Releases 


CUG361 Gadgets and Term 

Jack E. Ekwall has contributed a 
function library Gadgets, a group of 
UNIX-like tools for DOS; and Term, 
a collection of computer buzz-words. 
Gadgets provides functions such as 
popup/dropdown window, drawing 
box, screen and cursor manipulation, 
keyboard input, color, date, printer 
and mouse control, and file manipula- 
tion. Some of the functions are lifted 
from CUG273 Turbo C Utilities. The 
library is linkable to Turbo C v2.0. 
These UNIX-like tools offer a solu- 
tion to the DOS command line inter- 
face pipeline problem. Term includes 
634 topics and 32 historical notes/ob- 
servations about computer buzz- 
words. This text is in a text-indexed 
sequential form which can be read by 
a display program, VU. The distribu- 
tion disk includes source code for the 
library and documentation. 


Kenji Hino is a member of The C Users’ Group technical staff. He holds a B.S.C.S. from McPherson College and an undergraduate 
degree in metallurgy from a Japanese university. He enjoys playing drums in a reggae band. 
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User Report 


Zinc Interface Library 


Comments by David Brumbaugh 


Introduction 


The Zinc Interface Library is a C++ user interface library 
from Zinc Software Inc. for PC compatible computers. It sup- 
ports MS-DOS text mode, MS-DOS graphics mode and MS- 
Windows 3.x interfaces. I’m reporting on Zinc Version 2.0 for 
Borland C+ +. Zinc also supports the Zortech C+ + complier. 

C programmers moving to C++ and experienced C++ 
programmers will find the Zinc Interface Library helpful. I’ve 
been using it for over a year on projects I’ve been working on 
at home. 


Features 


Zinc’s primary feature is a C++ class library. It consists of 
class definitions, object code and optionally, source code for 
those classes. The class library is designed so that your applica- 
tion only needs to have one set of source code for writing ap- 
plications in text mode for MS-DOS, graphics mode for MS- 
DOS (CGA, EGA, VGA, Hercules compatible) and MS-Win- 
dows 3.x. 

The user interface created in all three modes is SAA com- 
pliant. This means it has windows, menus, dialogue boxes, list 
boxes, optional mouse support, and all the other features users 
have come to expect in modern software. 

All three modes, text, graphics and MS-Windows have the 
same basic look and feel. The UJ_DISPLAY class encapsulates 
the three display types in its descendants. The UI_ DISPLAY 
class defines all the things that a program can do to a user's 
display. 

Text mode applications use the PC extended ASCII 
graphics set for windows. The programmer has several options 
when using text mode: 


1. The application can automatically detect the current text 
mode and use it. This is the default. 

2. The programmer can explicitly use 25x80, 25x40 or 43x80 
(which gives 50x80 on VGA). 

3. The programmer can give the user a choice on which 
mode to use. 

Graphics mode MS-DOS display classes use complier 
specific libraries. The library I have uses BGI (Borland 
Graphic Interface). The documentation indicates that there is 
similar support for Zortech’s graphic library. An application 
can switch from graphics to text mode and back without loos- 
ing the information in the user’s windows. Besides the text 
mode features, the graphics display classes have support for 
graphic specific features like arcs, polygons, bitmaps, etc. 


Editor’s Note: 


As this issue went to press, we were informed that Zinc 
Interface Library v3.0 is now available. According to a 
Zinc representative, version 3.0 addresses some of the 
problems noted in this User Report. New features include 
direct use of Windows bitmap functions; MDI support for 
Windows and DOS; new window objects such as toolbar, 


combo box, checkbox, radio button, and buttons with as- 
sociated bitmaps; Zinc Designer adds a toolbar and access 
to all library features including user functions and valida- 
tion routines. For more information contact Zinc Software 
Incorporated, 405 South 100 St. Suite 201, Pleasant 
Grove, UT 84062, (801) 785-8900, FAX (801) 785-8996. 


———— ee ee ee ee, es 
David Brumbaugh is a project manager at Advanced Information Services, asystems integrator in Peoria, IL. He has been programming 
in C for over fiveyears and in C+ + for over a year. He can be reached by mail at 2807 N.Renwood Ave., Peoria, IL 61604. 
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While one MS-DOS application can support both text and 
graphics, you must recompile your program to support MS- 
Windows. You also must add a couple of #ifdef statements to 
call WinMain instead of main, and to redefine how colors are 
used, Other than that, all my MS-DOS applications, including 
graphic applications, ran without modification on MS-Win- 
dows. 

The strong points of the class library far out-weigh the 
weak points. Because the class library is set up in a very logical 
hicrarchy, it is easy to learn. 

The field validation capability is one of my favorite fea- 
tures. All user input can be validated by the program. Most 
common validations are included and the programmer can 
define his own easily. 

The library is fairly robust. Most of the errors I found in my 
programs were my own. When they weren't there was usually a 
fix on their BBS. The library is complete and generally well 
designed. 

The only weak points that I found were in the MS-Win- 
dows mode. The first is that since it always displays its bitmaps 
one pixel at a time, bitmap displays in MS-Windows are very 
slow. 

When I tried to work around this by using Windows bit- 
maps, I discovered that there is no obvious way to use Win- 
dows resources with Zinc. Zinc has its own version of resour- 
ces, and the BBS contains some programs to convert Windows 
bitmaps to Zinc bitmaps and Windows icons to Zinc icons. 

Finally, Zinc doesn’t have any direct support for MS-Win- 
dows Multiple Document Interface (MDI). MDI applications 


The Measure of 
a Great Program. 


PC-METRIC™: The Measurement Tool For Serious Developers. 


keep all the child windows of a main window confined within 
the boundary of the main window. Some programmer’s will 
see this as a bigger problem than others. 

The other major feature that comes with Zinc is the Zinc 
Designer. The Zinc Designer is a program that allows the 
programmer to draw windows, dialogues, menus, bitmaps etc. 
Using the Designer is faster than writing the equivalent source 
code. It allows the programmer to make better “Look and 
Feel” decisions. 

I found several weak points with the Designer. Some of the 
features that Zinc supports, like radio buttons and check 
boxes, are not supported by the Designer. The menu items in 
the Designer are cumbersome to edit. My final complaint is 
that the Designer generates only binary objects, not source 
code. I would like to see both. 


Documentation 


The Zinc documentation consists of three books: The 
Programmer’s Guide, The Programmer’s Tutorial, and The 
Programmer’s Reference. It also includes a Quick Reference 
Guide containing a list of the most common constructors, 
flags, event information, and a class hierarchy. 

The Programmer’s Guide provides a good overview of the 
concepts in the Zinc Interface Library. It is a short book that 
hits the most important points of the library. It also contains a 
user’s guide to the Zinc Designer. 

The Programmer’s Tutorial is a clear and simple book to 
help the programmer get started. It is short enough to stay 
interesting. That is a major accomplishment when you consider 
that it not only contains lessons on using 
the Zinc Library, but a C++ and ob- 
ject-oriented design tutorial as well. The 
examples are excellent. They are clear 
and many are useful building blocks for 
your own applications. 

The Programmer’s Reference is a 
well organized book that covers most of 
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PC-METRIC is the software measurement tool 
that measures your code and identifies its most 
complex parts. So you can spend your time 
working in the areas most likely to cause 
problems. 


PC-METRIC is fast, user-configurable, and 
includes a wide array of commonly accepted 
measurement standards. 


Plus, versions of PC-METRIC are available to 
support virtually every popular programming 
language. 


A Great Value By Any Measure. 


PC-METRIC’s price is only $199, and it comes 
with a 30-day money-back guarantee. Multiple 
user discounts are available, as well as site 
licenses and complete source code. 


Order Now! Call (503) 829-7123. 


SET LABORATORIES, INC. 
“Quality Tools For Software Craftsmen” 
P.O. Box 868 
Mulino, OR 97042 
Phone: (503) 829-7123 
FAX: (503) 829-7220 
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the classes that come with Zinc. It could 
be more complete in its handling of 
specific classes. For example, the width 
parameter in the Line method of 
UI_DOS_BGI_DISPLAY is ignored. I spent 
about two hours trying to find the bug 
in my code before I checked with tech- 
nical support. They agreed that it 
should have been documented. 


Support 


I have found Zinc technical support 
to be absolutely terrific. I usually use 
the Zinc BBS for support. It is well or- 
ganized and well maintained. It contains 
corrections, news, user contributions 
and additional examples. The message 
base provides contact with the people at 
Zinc and with other users. I usually 
search the message base and find the 
answer I’m looking for without having 
to post a question. 
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When I can’t wait for the BBS I call Zinc’s voice line. I’ve 
never had a long wait when I've called. The support people are 
very friendly, helpful and knowledgeable. They usually under- 
stood my problem better than J did and had helpful sugges- 
tions in addition to the answers to my questions. 


Competition 


Borland’s ObjectWindows and Turbo Vision are the other 
C++ user interface libraries I am familiar with. Borland chose 
to use separate class hierarchies for MS-DOS text and MS- 
Windows user interface. That means that if you want to write 
one application for both MS-DOS and Windows, you have to 
write two separate programs. 

ObjectWindows has more direct support for MS-Windows 
than Zinc. It includes classes that can use Windows resources, 
for example. But, it lacks the field specific editing features, like 
datesgthat Zinc has. 

Turbo Vision is a text mode user interface class library. It 
has features Zinc doesn’t, like the THistory class that allows 
the user to keep a list of data entry choices. It also lacks cer- 
tain features, like the extensive field support, that Zinc has. 
Turbo Vision also lacks the MS-DOS graphics support that 
Zinc has. 

Generally, if you’re doing strictly MS-Windows program- 
ming, Borland’s OWL has a slight edge because it is strictly for 
Windows. Its bitmaps are displayed faster, it can use resources 
from Borland’s Resource Workshop (or other sources) and 
there is full MDI support. 


Notice 
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Occasionally, The C Users 
Journal makes its mailing list 
available to vendors of products 
we think our readers will find in- 
teresting. Current subscribers 
receive free information in the 
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*C-ISAM Is a trademark af Informix Software.. 
Unix a trademark af AT&T. 


MAKES CURSES 
obsolete! 

@ 'W’ is a windowing library for 'C’ 

@ 'W’' gives you prioritized windows 

@ 'W’ offers complete control of 
any terminal 

@ 'W’ drives the DOS Memory map 

@ 'W' has line graphics and bells 

e ‘W’ has soft keys 

@ ‘W’ offers ‘hot key’ contro! 

@ 'W' prints screens even in UNIX* 

@ Describing terminals is much easier 
with ‘W’ than termcap 

@ It's easy to port from curses to ‘W’ 


@ $295 (U.S.), you get SOURCE for 
UNIX* & DOS 


If you want to write strictly text mode programs, Zinc has a 
slight edge over Turbo Vision because it has more support for 
formatted and validated data entry ficlds. If you want to write 
MS-DOS graphics mode programs, Zinc wins hands down be- 
cause neither Turbo Vision or OWL supports that mode. 

If you want to write applications that can be used across all 
three platforms, I recommend Zinc because you'll be doing 
less rewriting of code, The Zinc library fulfills the promise of 
code reuseablity much better than either ObjectWindows or 
Turbo Vision. 


Conclusion 


The Zinc Interface Library is a good value, There is no 
doubt that Zinc will save time for C++ programmers who 
write programs for the PC. It lets you program for three PC 
platforms in the time it usually takes to write code for one. 
The examples of C++ code will be of great help to the new 
C++ programmer. The library is an example of good Object 
Oriented Design. 

I have only two suggestions for improvements. I would like 
to see a more complete reference manual. I also would like to 
see the Windows library have more support for the features of 
Windows 3.x. 

I would recommend the Zinc Interface Library to any C+ + 
programmer who wants to write applications for the PC.O 
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32-Bit C Code Generation 


Gpf Systems, Inc. has released Gpf 
v1.3, an upgrade of its Gpf (GUI Program- 
ming Facility) tool for OS/2 Presentation 
Manager applications. The new version ex- 
tends the platforms on which Gpf-generated 
applications can run by enabling developers 
to create native 32-bit applications. It also 
allows developers to define custom graphi- 
cal objects for the user interfaces they 
design. 


Quick and Cool PLD 


Intel Corp has introduced a high-per- 
formance CMOS 22V10 compatible 
programmable logic device (PLD) running at 
100-MHz count frequency with a 10 
nanosecond (ns) propagation delay. 

Intel’s CMOS 85C22V10 PLD operates 
at 40 percent lower power than bipolar 
devices, thereby generating less heat. This 
translates into increased system reliability 
and decreased power supply requirements 
-—— important features for today’s compact 
system designs. 

Based on the largest-selling PLD ar- 
chitecture, the 85C22V10 is JEDEC com- 
patible with standard 22V10's and is 
supported by current 22V10 software. Op- 
tional superset features included are 
programmable clock inversion and addition- 
al signal feedback configurations. 

In quantities of 1,000 the PLCC and 
PDIP 10ns versions cost $9.50 and the i5ns 
versions cost $4.75. For further information 
call a local Intel sales office, or the Literature 
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GUI Design Tool for OS/2 PM Adds 


Gpf runs on OS/2 1.3 Standard Edition 
or later versions, and it supports Extended 
Edition for those applications using OS/2 
DataBase Manager. The program requires a 
mouse and 1.5MB of available hard disk, and 
6MB of RAM are recommended. Gpf is 
licensed on a workstation basis and is priced 
at $995 for the first copy. For more informa- 
tion contact Gpf Systems, Inc., P.O. Box 414, 
30 Falls Rd., Moodus, CT 06469-0414, (800) 
831-0017, FAX (203) 873-3302. 


Center at (800) 548-4725 (in the U.S. and 
Canada), or write for: Intel Literature Packet 
#IP-87, P.O. Box 7641, Mt. Prospect, IL 
60056-7641. 


LS [ee ee ee ee 
Softaid Introduces 15 Mhz 
Z180 Emulator 


Softaid has released a version of its 
UEM In-Circuit Emulator for Zilog’s 15 Mhz 
Z180 processor. The Z180 offers a 280 
processor core with an extensive suite of 
on-board high integration peripherals. 
Recently Zilog introduced a 15Mhz version 
of the Z180, giving embedded designers 
access to more computing horsepower 
while maintaining software compatibility 
with their older Z80 code. 

The UEM includes 131,072 hardware 
breakpoints, a 4KB deep real time trace 
buffer, performance analysis, and a memory 
access monitor. It comes complete with a 
Source Level Debugger that supports essen- 
tially all C and PL/M compilers. 

Softaid also offers a free Guide to 
Developing Z180 Applications, for those 


New Products 


Industry-Related News 
& Announcements 


designers needing a little more information 
than provided in Zilog's sometimes cryptic 
data sheets. 

The 15 Mhz 2180 UEM costs $6500.00 
and is available from stock. For more infor- 
mation, contact Softaid, Inc., 8300 Guilford 
Rd., Columbia, MD 21046. (800) 433-8812. 


ene ae nen ene neem 
Demo Maker/Player Programs for 
Software Systems Running Under X 


Non Standard Logics, Inc. (NSL), has 
released a set of programs that allow 
developers working in X to create demos of 
their software quickly and inexpensively, 
with unlimited distribution of the demos at 
no cost beyond the initial purchase price. 

Designated XDemoMaker and X- 
DemoPlayer respectively, the two-program 
set employs an OSF/Motif graphical user 
interface, but demos produced are inde- 
pendent of the GUI and min under any X 
terminal graphical user interface used with 
the application. The program incorporates 
editing tools for fine-tuning the demos and 
for including text to amplify on the activities 
displayed on the screen. Complete or partial 
sequences can be repositioned within a 
demo by means of "Cut-Copy-Paste-Dupli- 
cate” commands. 

XDemoPlayer is licensed to pur- 
chasers of XDemoMaker for use on specific 
platforms with unlimited copying rights, 
enabling developers to distribute their 
demos with the playing program in quantity. 
A standard 1.44MB diskette accommodates 
both the XDemoPlayer software and a demo 
of several minutes’ length. Longer demos 
can be circulated on tapes and compact 
disks. 

Single unit price for XDemoMaker is 
$6,000. XDemoPlayer is licensed for $4,000 
for the first platform with discounts available 
for additional platform versions. Unlimited 
copying rights are included with the player 
license. The programs are now available for 
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IBM, DEC, Sun and Hewlett-Packard 
workstations. For more information, contact 
Non Standard Logics, Inc., 4141 State Street, 
Suite B-11, Santa Barbara CA 93110, (805) 
964-9599, FAX (805) 964-4367. In Europo, 
contact Non Standard Logics SA, 57-59 Rue 
Lhomond 76005 Paris, France, (33) 1 43 36 
77 50, FAX (33) 1 43 36 59 78. 


Care eee 
New Release of Speededit 


Bradford Business Systems recently 
released SpeedEdit vA.04, a programmer's 
text editor for MS-Windows, X-Windows, 
DOS, OS/2, MPE-XL and other operating 
systems and platforms. This version adds 
support for SunOS and Hewlett-Packard's 
MPE-XL. Under each platform, save MPE & 
MEP-XL, SpeedEdit comes in one of two 
forms, a character version to operate on 
standard terminals or non-windowed con- 
soles and a Windowed version. The Speed- 
Edit system sells for $295 on all IBM-PC 
based platforms and $395 on single user 
UNIX workstations. Multi user UNIX sys- 
tems are priced according to the system. For 
more information contact Bradford Business 
Systems, Inc. at 23151 Verdugo Drive, Suite 
114, Laguna Hills, CA 92653 (714) 859-4428, 
FAX (714) 859-4508. 


Multilingual Software Toolkit 


Frontier Software Services has 
released the Translator’s Apprentice, a 
programmer's toolkit which allows the 
programmer to write programs for multiple 
languages (French, Spanish, Russian, etc). 
Using the toolkit, programmers can create 
multi-lingual programs which start up ina 
user's choice of language and switch from 
one language to another at the press of a 
key. 

The package simplifies the tasks of 
the analyst, programmer, and translator by 
providing a mechanism for the translation 
and update of textual material in an applica- 
tion without requiring changes to the pro- 
gram for each translation. 

The toolkit costs $175 for the Text 
Manager and Access Functions, including 
source code and a 30 day money-back 
guarantee. Site licensing is available. For 
further information contact Frontier 
Software Services at 31 Mystic Avenue, 
Winchester, MA 01890 (617) 729-2161. 


Debugging and Data Capture Tool 


Paladin Software, Inc. is now ship- 
ping an upgraded version of DataScopeTM, 
the communications debugging and data 
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ProtoView Development has released 
ProtGen 2.1, a visual program design and 
code generation tool for Windows applica- 
tion development. Similar to ProtoGen 2.0, 
sold by Borland International, version 2.1 
features a menu designer and dialog linking 
interface. It also generates code for both 
ANSI C and Borland C++ Object Windows. 

Using a C++ class object, ProtoGen 
2.1 also allows C++ programmers to tap into 
the Proto View dynamic link libraries to 
access advanced data entry and validation 
capabilities. Masked input, date, currency, 


capture tool with applications in the com- 
puter programming, manufacturing, in- 


‘dustrial automation, and multimedia 


industries. Version 2.0 saves time and 
money, eliminates guesswork by allowing 
the user to apply powerful display and 
search tools to ordinarily invisible transmis- 
sions, and provides an alternative to expen- 
sive hardware line monitors. 

DataScope is the only serial line 
monitor that includes context-sensitive Hy- 
pertext, Hypersetup, and user-alterable 
multitasking window displays. Version 2.0 
offers a user-friendly, "windows-like” pull- 
down menu interface. 

For further information contact 
Paladin Software, Inc., 3945 Kenosha 
Avenue, San Diego, CA 92117, (619) 490- 
0368, FAX (619) 490-0177. 


Professional Input Validation 
for MS-Windows 


MantaSoft Partners have released In- 
Control, a new set of DLLs, with source code 
available, that will enable programmers to 
include professional input validation in their 
Microsoft Windows 3.0 applications. These 
DLLs are compatible with Microsoft Win- 
dows SDK, Borland C++ 2.0, Borland Turbo 
Pascal for Windows, Whitewater's Actor 
and Microsoft Visual BASIC. 

InControl Toolbox defines thirteen 
new classes of controls for Microsoft Win- 
dows. The controls are broken into two 
logical groups: display and input. Display 
controls are used to display information toa 
user of a Windows application. Input con- 
trols are used to control the information that 
a user enters into a Windows application. 

InControl Toolbox contains two dis- 
play controls. These are the Time control 
and the Date control. It contains 11 input 


Visual Program Design and Code Generation Tool 
for MS-Windows 


numerics and table colection controls and 
more, give a cophisticatecd look and feel with 
no coding effort. 

ProtoGen’s price is $199.00, but is 
now available at the introductory price of 
fust $49.95. Upgrades for current users are 
also $49.95. It requires a PC with 80286 or 
higher processor running Windows in 
protected mode. Code generated by Proto- 
Gen is royalty free. For further information, 
contact ProtoView Development Corpora- 
tion, 353 Georges Road, Dayton, New Jersey 
08810, (908) 329-8588. 


controls, The input controls are broken into 
three groups: Formatted, Numeric and Free 
Format. The Formatted group contains con- 
trols which allow the input of Zip Codes, 
phone numbers, Social Security numbers 
and dates. There {s also a programmer 
defined Formatted control that alows the 
programmer to define, at a character-by-char- 
acter level, the allowable input for a given 
control. This control uses a dBase-like com- 
mand string to describe the aLowable input, if 
any, at a given position in the input control. 

The Numeric group contains controls 
that allow the entry of integers, floating 
point numbers and dollar amounts. Each of 
these controls allows the entry of negative 
numbers and has an option which allows the 
programmer to set a legal range of values. 

The Free Format group consists of 
two general entry controls. They are called 
general entry because they accept any input 
and, upon losing focus, try to determine if 
that input corresponds to a legal value. The 
first of these controls is the Free Format Date 
control. This control will try to determine 
what date the user meant from the given 
input. For example: a value of “F392” would 
yield the result “February 3, 1992” or 
“02/03/1992" depending on a style flag. 
Other allowable inputs are "Next Week", 
“Last Friday”, "Today" and “Yesterday”. 

The second general entry control is 
the Regular Expression control. This contrel 
uses a Grep-like regular expression to deter- 
mine if the value intered by the user was a 
legal value. 

For each of the input controls, a 
programmer can assign a function that is 
called when the control loses focus. This 
routine can be used to further validate the 
data entered or to immediately store the 
entered value into a variable in memory. 
This function notifies the control, through a 
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Industry-Related News & Announcements 


a ee ae eee 


C// for C++ 


Subtiesoft announced C// for C++: the 
C extension injecting real-time parallelism 
into a single C program, now combining the 
power of C// and the flexibility of C++. An 
unlimited number of run-time created, 
separable processes smoothly cooperate on 
common resources, self-parallel functions, 


queues, lists, events, timeouts. All the C++ 
communications and classical synchroniza- 
tion mechanisms are available, along with a 
powerful set of new C// weapons, including 
the new C// class of semiautomatic vari- 
ables, run-time control variables, double ac- 


cess to process arguments, stack 
monitoring, private stacks, processes with 
no stack, offsets, etc. Dynamic priorities and 
scheduling facilitate interprocess coopera- 
tion. Precise handling of external events 


retum value, whether it considers the value 
to be valid or invalid. 

Each control can notify the user of 
error conditions in two forms. A style can be 
set that causes an audible beep whenever 
an error is detected. Alternatively, a visual 
text message can be displayed immediately 
below the current input control which more 
fully describes the error. For example, if a 
user enters a ‘9° in a Formatted control ina 
location where the maximum value has 
been set to ‘5’, the control would display a 
message informing the user of the range 
violation. 

InControl Toolbox is available directly 
from MantaSoft Partners and retails for $179, 
or $249 with complete source code. Orders 
will also be taken by GUI Clearing House, 
which can be reached at 1-800-522-4624. 

For more information please contact Manta- 
Soft Partners, P.O. Box 203551, Austin, TX 
78720, (512) 335-3497, CompuServe 70314, 
1445. 


On a os 
ed aa Library 
With Added Memory Capability 


Library Technologies announces the 
addition of EMS/XMS/virtual memory 
capabilities to their programming library C- 
Heap for the Microsoft C and Borland C/C++ 
compilers. The 51 new functions give the 
programmer low-, medium-, and high-level 
functions for utilizing EEMS 3.2, LIM 4.0, 
XMS 2.0, and virtual (disk space) memory, 
with no 64KB limit on memory block size. 
The most powerful, high-level functions 
provide an automatic swapping mechanism 
(with locking capability) to completely 
remove the burden of managing 


Page 120 — The C Users Journal 


through the C// driver, user-programmed 
ISRs, urgent process executions, and the 
complete resolving of the problem with DOS 
and BIOS non-reenterability make C// for 
C++ a useful real-time tool 

C// for C++ provides good memory 
Management and performance. It provides a 
natural platform to pure object-oriented 
programming in addition to the C++ 
mechanisms. Real-time projects, com- 
munication and simulation software, inter- 
nal multitasking environments, advanced 
control software are effectively implemented 
in C// for C++. 

For further information contact Sub- 
tlesoft Intemational, 4344 Bristol Street, Pit- 
tsburgh, PA 15207; (412) 682-3934. 


EMS/XMS/vittual memory from the 
programmer, making the use of 
EMS/XMS/vmem an extremely simple mat- 
ter. At all function levels, the programmer 
specifies whether EMS or XMS is to be used 
preferentially, but the fucntions use 
whatever is available. If neither is available, 
or when EMS/XMS is used up, the medium- 
and high-level functions can use disk space 
automatically. The user of disk space can be 
selectively disabled, though, or memory can 
be allocated specifically from disk space if 
desired; thus, the programmer can be sure 
that memory is being utilized exactly as he 
wishes. All virtual memory I/O occurs 
through from zero to four disk caches of up 
to 16KB each in size, which the programmer 
may specify be allocated to dramatically 
increase the speed of virtual memory I/O. 
With the high-level functions, a “dirty bit” 
can be cleared to avoid writes to 
EMS/XMS/virtual memory when the data 
has not been changed, which can greatly 
speed execution. All functions are com- 
patible with malloc(), and all memory 
models but the tiny model are supported. 

These functions join the other 500+ 
assembly-language functions already in C- 
Heap, which deal with DOS memory 
management. The cost of C-Heap is $199, 
or $399 with source code. For further infor- 
mation contact Library Technologies, P.O. 
Box 56031, Madison, WI 53705-9331, (800) 
767-4214. 


Object Professional for C++ 


TurboPower Software announces Ob- 
ject Professional for C++, a powerful, time- 
proven library of text-mode user interface 


objects. Object Professiona) for C++ (OPC) is 
a straight port of the user interface objects 
from Object Professional for Turbo Pascal. 
OPC includes high-level objects such as text 
editors, dialog boxes, scrolling data entry 
screens, help systems, and more. The user 
interfaces are ready-to-use, and built-in 
calls allow programmers to customize the 
behavior. OPC does not use event-driven 
programming. Applications built using OPC 
will run nicely in 640KB 8088 based PC's. 

OPC includes utilities to help build 
menu systems and data entry screens. The 
utilities support interactive design and test- 
ing and then automatically generate source 
code. OPC includes full source code, 1,300 
pages of documentations, pop-up help, and 
plenty of example and demo programs. No 
payment of royalties is required. OPC re- 
quires Borland C++ 2.0 or 3.0 Object Profes- 
sional for C++ costs $249. For further 
information contact TurboPower Software, 
P.O. Box 49009, Colorado Springs, CO 
80949-9009, (800) 333-4160. 


a ea eee aT eer mar 
Shortcut for Rapid Application 
Prototyping 


Cadre Technologies Inc. announces 
the availability of ShortCutTM, a rapid ap- 
plication prototyping tool based on Cadre’s 
TeamworkR family of CASE products. 
Developed by Cadre’s exclusive Austrian 
distributor, Computer & Software Engineer- 
ing (C.S.E.), ShortCut incorporates a graphi- 
cal user interface (GUI) editor, a database 
access library, a compiler, and a rule-based 
expert engine. Working together these com- 
ponents enable application developers to 
capture, analyze and validate end-user re- 
quirements before designing and im- 
plementing the actual production system. In 
addition they allow developers to generate 
a complete and functional application 
prototype and enable developers and poten- 
tial end-users to interact with this prototype 
well in advance of the development of the 
code. 

With ShortCut, developers can under- 
stand end-user requirements from three im- 
portant application views: the user 
interface; functionality and control; and 
database access, which works with SQL 
databases such as Ingres, Oracle, and 
Sybase. 

Priced at $7,995 for a base configura- 
tion that includes a GUI editor, a compiler, 
and an expert runtime system, ShortCut is 
available immediately on Sun, DEC, IBM, 
and HP workstations. For further informa- 
tion contact Cadre Technologies, Inc., 222 
Richmond Street, Providence, RI 02903, (401) 
351-CASE, FAX (401) 351-7380. 
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New Products 


QO 
Database Independent 
Development Environment 


Convergent Solutions, Inc. (CSI), has 
released its database independent develop- 
ment environment, CS/ADS Release 6.3, for 
use with ShareBase Database Servers at- 
tached to Sun 4 and Pyramid MisServer 
computers, 

CS/ADS is a tool set for professional 
programmers. It provides a comprehensive 
high-productivity development kit for build- 
ing complex business applications and in- 
formations systems. A significant benefit of 
C8/ADS is that it allows applications to be 
built that are database independent, yet still 
incorporate the full power of SQL for the 
specific RDBMS. 

CS/ADS applications that are built for 
ShareBase can be easily moved to other 
RDBMS's by using CS/ADS for ORACLE or 
CS/ADS for Informix. 

The centerpiece of CS/ADS is a fourth 
generation programming language (4GL) 
that combines high-level constnicts and 
powerful abstract datatypes with the 
programming structure of traditional third 
generation janguages. The development en- 
vironment includes a dynamic data diction- 
ary that extends the data definition beyond 
the database schema by including editing, 
verification, and formatting rules for data 
fields. Also, CS/ADS comes with a suite of 
interactive, developer friendly utilities such 
as an advanced WYSIWYG screen painter 
and 4GL code generator, all of which are 
intergrated to both the data dictionary and 
the RDBMS schema. 

CS/ADS for ShareBase II will be ini- 
tially available for Sun 4 and Pyramid ar- 
chitectures. The software will be ported to 
other CS/ADS supported platforms later this 
year. 

For more information contact Conver- 
gent Solutions, Inc., 100 Metro Park South, 
Lawrence Harbor, NJ 08878, (908) 290-0090, 
FAX (908) 290-1494. 


Program Language Translation 


Shannon Associates’ METAMOR- 
PHOSIS is a generic utility program which 
facilitates the transformation of any syntac- 
tically reducible character-oriented file to 
other forms. Given the syntactical definition 
of the source and target languages, 
METAMORPHOSIS will translate source 
programs from one language to another; ie: 
FORTRAN to Ada, JOVIAL or Ada, any 
language to C, dialect conversions, etc.. 
METAMORPHOSIS also functions as a cus- 
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Microware Systems Corporation now 
offers an optimized version of OS-9 for the 
Motorola MVME167 single board computer. 

This latest version of OS-9 for 
Motorola microprocessor-based products al- 
lows designers to take full advantage of the 
32-bit M68040 processor, while providing 
support for the on-board seria], SCSI and 
Ethernet hardware. 

The OS-9/167 Development Pak in- 
cludes a number of new OS-9 device drivers 
for the next generation I/O peripherals in- 
cluded on the MVME167 board family. 
These include new SCSI drivers for the NCR 
530710 controller which support Common 
Command Set flexible and hard disk drives 
and tape units. Additional drivers are in- 
cluded to support the on-board real-time 
clock and new CD-2401 serial I/O controller. 

Full Ethernet support is provided by 
means of the OS/9 Internet Support Package 
(ISP) and new device drivers for the Intel 
82597 Ethernet Controller. ISP allows an OS- 
9/167 Development Pak system to remotely 
login and transfer files between an 
MVME167 and UNIX or DOS nodes on an 
Ethemet network. Support for BSD socket- 


tom compiler, assembler, macro processor, 
graphics language processor and report 
generator. Further, METAMORPHOSIS 
facilitates reformatting of data base files and 
analysis of natural language, grammar, se- 
quential and parallel procedures and com- 
putational signatures. 

In addition to generic METAMOR- 
PHOSIS, preconfigured METAMORPHOSIS 
translators including FORTRAN IV to C PL 
(Subset G) to C, and CMS-2M to Ada are 
available for immediate delivery. 

Generic METAMORPHOSIS, 
FORTRAN IV to C, PL/I (Subset G) to C and 
CMS-2M to Ada sell for $387, $87, $87, and 
$134 each, respectively. All execute on the 
IBM PC, PC/XT, PC/AT and compatibles 
with minimum 416K RAM, monochrome 
monitor, two 360K bytes 5.25" DSDD floppy 
drives, optional printer and MS-DOS / PC- 
DOS 2.0 or revisions. 

Contact J.H. Shannon Associates, 
INC., P.O. Box 597, Chapel Hill, NC 27514 
(919) 929-6863. 


New Name for Raima Product 


Raima Corporation announces that 
they are changing the nomenclature of 
db_VISTA, the high performance database 


OS9 for Motorola Single Board Computer 


based interprocoss communication {is also 
provided. 

The OS-9/167 Development Pak also 
includes a full set of resident development 
tools designed to jump-start application 
development. These tools include a full K & 
R C Compiler, Macro Assembler and Linker, 
User State Debugger, (mu)MACS full screen 
editor, Shell Command Interpreter, and 
numerous utility programa. 

OS-9/MVME167 {s available in two 
versions. The OS-9/167 Development Pak 
includes the OS-9/167 Real-Time Operating 
System modules and device drivers as well 
as the full suite of development tools. Cost 
for the Development Pak is $3,000. The OS- 
9/167 Run-Time Pak provides only the OS-9 
Real-Time Operating System modules and is 
intended to provide target system 
functionality. Quantity one pricing for the 
Run-Time Pak {is $1,500. Contact Microware 
for multiple-copy licensing information. Both 
packages are available now. 

For more information contact 
Mictoware Systems Corporation, 1900 NW 
114th Street, Des Moines, IA 50325-7077, 
(515) 224-1929, FAX (515) 224-1352. 


management system, to Raima Data 
Manager. This move is in line with the 
company’s new corporate image campaign 
of relating its product names to their specific 
technology. 

The Raima Data Manager DBMS is 
best known for its high performance in ap- 
plications development, and for its com- 
bined database technology of relational and 
network models. 

Raima began the new naming cam- 
paign last June when they introduced Raima 
Object Manager, a storage class library tar- 
geted in the C++ and obfect-orientated 
marketplace. 

The name change to Raima Data 
Manager accompanies a new update 
release, version 3.21. The update does not 
plesent new features, but includes fixes to 
the current 3.2 version. 

Raima Data Manager will continue to 
be marketed as both a stand-alone product, 
and as a full system accompanied by 
db_QUERY and db_REVISE. db_QUERY is 
an SQL-based query and reporting module; 
db_REVISE is a sophisticated database 
restructuring tool. 

For further information contact Raima 
Corporation, 3245 146th Place S.B., Bellevue, 
Waal, (800) 327-2462, FAX (206) 747- 
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NL 


We Have Mail 


We ask that letters with code listings be 
submitted in an ASCII text file on an MS- 
DOS formatted disk. Providing us an 
electronic copy of the code will prevent 
typographical errors that might result 
from optical scanning or re-keyboarding. 


Dear Sir, 

I see that Randall Bart has raised 
the question of C++ vs. ++C. My own 
understanding is that the language is so 
named because every time you think 
you've finished learning it Bjarne adds a 
new feature. 

Yours faithfully, 

Scott Wheeler 

BMT Research, Orlando House 
1 Waldegrave Rd., 

Teddington, Middx 

UK TW11 8L2 


Wish I'd said that first. — pjp 


Gentlemen; 

It seemed good to take this oppor- 
tunity to thank you for the work your 
staff has done this past year, and the ap- 
preciation many of us have (who don’t 
write) for the quality of The C Users 
Journal. As a CPA, and accounting 
software developer, each new monthly 
issue frequently discusses and answers a 
current concern of mine. I can’t tell you 
the number of times an article appeared 
at exactly the moment I needed the in- 
formation. True, many articles are over 
my head and I marvel at how so much 
can be written about something I know 
So little about. ' 

It also seemed good to nominate Mr. 
Leor Zolman as CUJ Writer of the 
Year. This in no way slights the efforts 
of the others, but my vote is based on 
the following criteria: 

Appropriateness and general useful- 
ness of subject: A. 

Scope and technical considerations 
covered: A. 

Ability to adapt subject material to 
other applications [portability]: A. 

Tutorial content of material and use- 
fulness in teaching C language concepts 
and capabilities: A 
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Humor and ‘tongue in cheek’ writing 
style (a spoonful of honey makes the 
medicine go down): A 

Future subjects that would be of in- 
terest to me and perhaps others are sug- 
gested for your consideration, and in- 
clude: 

DOS TSRs: For example, how would 
one adapt Mr. Robert Bybee’s article 
“A Portable VMS-Style Input Line 
Routine” to function as a TSR, similar 
to Peter Norton’s NDE referenced in 
the article. 

Keyboard I/O: A routine for polling 
the keyboard buffer. CUJ had an article 
on this subject some time ago, but it 
either did not go far enough or was 
beyond my ability to understand. The 
scope of the routine would be in two 
parts: (1) the ability to capture user 
keystrokes from an application and log 
them into an ASCII script file (perhaps 
subsequently edited by the user), and 
(2) the ability to call this routine and 
load the named script file into the key- 
board buffer. In this way, users should 
be able to run repetitive applications or 
set up a series of applications (reports) 
to be chained together and run as a 
batch. 

Batch File Compilers: Sometime ago 
I downloaded a batch file compiler from 
CompuServe, written by Douglas Boling 
(PC Magazine Ziff Communications). 
The language concepts I think that are 
required should make an interesting ar- 
ticle. (I would love to know how this 
program works.) The input file consists 
of a standard W S batch file which is 
then compiled on the fly and a .COM 
file written to disk. How is this done? 

Help Compilers: Beginning with 
standard documentation files (ASCII) 
as might be produced by a word proces- 
sor, how would one build a compiler to 
translate ASCII files into an indexed bi- 
nary format. The help utility program 
would access a file name passed on the 
command line, display an index for user 
selection, then handle paging and text 
display with keyboard control. Based on 
Leor’s current article, this should be a 
piece of cake for him to take on as his 
next project. (You’re welcome, Leor.) 

Enclosed with this letter is my sub- 
scription renewal and disk order for 
processing. 

Thanks again for your quality work 
in past years and may this year generate 


even more success for R&D Publica- 
tions. 

William C. Moench, CPA 

North Gate Software 

29204 Knickerbocker Rd. 

Bay Village, Ohio 44140 


It’s always nice to hear when we do 
something right. Thanks for writing. — 
pip 

Leor responds: 

Gee, if they'd given me report cards 
like that when I was a student at MIT, 
perhaps I wouldn't have dropped out! On 
the other hand, this kind of feedback 
probably means more to me than any real 
report card I've ever received. Thank you 
much. 

I find it difficult these days to sit down 
and write a program just as an intellectual 
exercise; usually, I have to have an actual 
need for the program before I’m 
motivated to write it (that’s partially why I 
have resisted getting into into program- 
ming Windows; the other reason, a lack 
of elegant development tools, however, 
seems to finally be lifting...) Most of the 
material for Illustrated C derives from 
applications I've written and put into ser- 
vice pretty much as they appear in the 
column and, now, the book as well. 

Incidentally, when bugs pop up, it’s 
usually because the program hadn't gotten 
enough use yet. I'm too scatterbrained to 
debug by inspection; I have to debug by 
“using” — yes, otherwise known as trial- 
and-error. Plus, I’m a perfectionist. If 
nothing else, that makes for an entertain- 
ing development cycle. Well, in the im- 
mortal words of our distinguished publish- 
er, “OK, I'm done.” 


Dear Mr. Phillips: 

I very much enjoyed Part 5 of your 
series on Image Processing. It has 
stimulated some creative thought 
processes in me and for that I thank 
you. I did notice one problem with your 
examples which caused me to write this 
letter. The discussion below will clarify 
the situation. 

The Kirsch, Prewitt, and Sobel trans- 
form sets are designed to detect edges 
in only one of the eight compass direc- 
tions. As such, they can only be applied 
to the original image and can not be 
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Programmer’s 
Market 


PostScript From C! 


- _pslib £. 
“Complete Set of Grapifits Functions \ 


Text Functions for fonts. lines. paragran 
/ o Dounioatebie Font supe y-* 
v Encapsulated PostSckipt 


|_.c_psFontInfo 


/ Stringwidth:Calculations _ 
Font Reencoding ~~ ve 7 
/ Keming,, Ligauures, & Morel” =." 


Site License $595 seh 
Single User License $195 each 
ANSland K&R Source Code Included 


Barton Creek Software 
2222 Western Trails Suite 106, Austin, Texas 78745 


512-441-8354 


+ Request 471 on Reader Service Card + 
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Optimize Your Object Code 


Segment Consolidator 
An inter-object module 
optimizer 
Convert large code model code to 
mixed model, delete dead code, convert 
to register parameter passing, convert to 
pascal stack clearing convention. No 
source code modifications required. 
Output is in ready to link object module 
format. Supports C language MSC 6.0, 


Borland C++ 3.0, Assembly generated 
and runtime library object modules. 30 
day money back guarantee. Only 
145.00. 


Optimite Systems 
1000 Singleton Blvd 
Dallas, Texas 75212 

(214) 745 1301 


+ Request 188 on Reader Service Card + 
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TM MPW 295); DOS Vol 1,2 &3 
Any volume $125; any 2 volumes 
¥ $225; All $300); Sun UNIX (}495) 
Programmer's 
Toolbox 


Dialects: Microsoft C6.x; MPWC; 
Think C; Turbo C; Unix C; ... 


30 Day Money 
Hock Guarantee 


Unlimited number & alzea 


CLint™ -Syntatically check one or mare files & generate 
ANSI function prototypes; CFlow™ - Determine 
Program organization, functlon and file 
interdependencies and runtime Nbrary cantenta; 
CPrint™ - Reformat/beautity C & C++ sauree code; 
Chref™ - Cross reference and check symbol usage, and 
identify unused files; CDecl - Translate and compose C 
declaration statements; CHI ite™ - Highlight & print C 
source files (MPW only); pAre™ -File archiver with great 
compresslon (DOS only); pLn™ - UNIX symbalic links 
in DOS; PMon™ - Program profiler (DOS only); Cpp - 
flexible ANSI C preprocessor; plus many more... 


Se TMM Call: (510) 770-0858 


MasterCard Via2 Acnepted 
Buy 2 PC volumes 
and get 3rd free! 


MMC AD Systems 
+ Request 152 on Reader Service Card > 


Box 360845 
Milpitas,CA 95036 


Neural CASE™ 


More than a shell - a complete neural network 


application development environment, Train, test, and 
deliver your application using one product. Supports 
four network paradigms: BPN, CPN, FLN, and SOM. 
Object-oriented approach - casily create and configure 
VO and network objects using a powerful menu-driven 
GUI Weights generated can also be used by the 
Neurocomputing Library. Introductory price: $199, 


Neurocomputing Library 


A library of C neural network functions featuring: twelve 
popular neural network paradigms, multiple networks 
and paradigms in a program, example programs, and 
coyalty-free distribution of applications. Supports 
Turbo C 2.0, Turbo C++ V1.0, Microsaft C 5.1, or 
Zortech C++ (please specify when ordering). $179. 
Library with source $379. 


NeuroSym® Corporation 
P.O. Box 950683 * Houstan, Texas 7709R-0683 © (713) 525-5777 
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—_ If You Program inc 
Bl> You Need This Make Utiltysa> 
Programmer's SUPER-MAINT =» ™ 


Professional make utility automatically 
writes your make and response files for 
you, remembers your command flags, the 
make file name, and more! Leaves all but 
about 2K of your oremory for compilers to 
use. 30 day money back guarantec. 


Now Vorsion 3 has Smart Library Maintonanco, on- 
the-Ay rosponso flo building, mutipla modcls bu® 
with ono cammand. *Point and shoot" at codo files 
you want in your program, mutipls sotups. usor 
confiqumbls. Cantrol how your program is buit from 
the command lina using simpla mnemonic flags. Still 


only $55 (ple 3.00 e&th, NY residents add sales tax), 


EmmaSok 

PO Box 238 

Lansing, NY 14882 
Voice: (607) 533-4685 
BBS: (607) 533-7072 


Ss 
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Writebar Barcode Products 


Wilsoft carries a complete line of bar 
code software and hardware for your 
every need. All major bar code types 
supported. Callthe most experienced 


company in the bar code field today. 
DOS and Xenix/Unix support. Por- 
table readers too! VISA/MC/AMEX 


109 NW 22 Street 
Ft. Lauderdale, FL 33311-3834 
(305) 779-2720 
(305) 763-3096 Fax 
(800) 765-4114 Sales 
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PAUWELS 


A catalog of DOS & OS/2 software on 
your computer. Crass - referenced 
on product name, category and 


editor. Monthly updates. 


The PAUWELS CATALOG is 
distributed as shareware (available 
on Compuserve - !BMAPP - file 
PAUWEL. EXE) 


A tool for programmers, MIS 
departments and software dealers. 


Pauwels & Partners Software 


NX ri 
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FIGHT 


YOUR 
PROGRAM 
$$$’s! 


Since 1986, companies worldwide have been 
choosing Az-Tech security products. If you 
demand the rel a protection available. why 
not choose one of these “proven leaders”: 


« EVERLOCK Copy Protection 
+ EVERTRAK Software Security 
» EVERKEY II “The Lock” 


For IBM and Compatibles. 
30 day money back guarantee. 
Free info and demo disk available. 


Az-Tech Software, Inc. 
201 East Franklin, Ste. 11 


Richmond, 
(800) 227-0644 vo MO 64085 


(816) 776-2700 
FAX (816) 776-8393, 
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cascaded, The reason for this is that 
each individual transform is designed to 
REJECT and REMOVE information 
from its output which does not cor- 
respond to a gradient in the direction of 
interest. I noticed in the photo examples 
that the images had a distinct bias in 
favor of one gradicnt over the other. 
For example, the right edges of dark ob- 
jects are shown but the left edges of 
dark objects are missing. This is due to 
the fact that you have applied the trans- 
forms in cascade. The correct use of 
these transforms dictates that they each 
be applied to the input image and then 
the results analyzed. 

It should be noted that it is not pos- 
sible to merely sum the outputs from 
the eight transforms of the Kirsch and 
Sobel sets since this would result in 
values of zero. With these sets however, 
it is possible to accumulate the absolute 
value of the transform output. Since the 
transforms with opposite compass direc- 
tions create symmetrical output, it is 
only necessary to use the absolute value 
of four patterns. The strong negative 
output of the one direction matrix 
provides the detection capability pre- 
viously provided by the opposite trans- 
form. The output of the eight Prewitt 
transforms may be summed to non-zero 
values but it may be advantageous to 
use the same feature of symmetry to 
avoid redundant calculation. 

I hope that this comment is not too 
brief and that you find the information 
useful. Again thanks, and I look forward 
to your next article. 

Sincerely, 

Frank Evans 
Intelledex Vision Products 


Dwayne Phillips replies: Thanks for 
the comments. 


Gentlemen; 

I have just gone through the process 
of learning how to use TLIB, including 
15 minutes on “hold” in a telephone call 
to Borland. As an ex-professor (of a 
technical subject), and as a novice C 
user, I feel it is necessary to make two 
comments and to editorialize on Mr. 
Pugh’s answer to Mr. Sam LeFevre, of 
Idaho Falls, as presented in the October 
1991 C Users Journal. 

Mr. LeFevre introduced himself as a 
“novice Turbo C user,” and asked for 
guidance in setting up his own library of 
functions. Mr. Pugh correctly advised 
him to use the TLIB program supplied 
with Turbo C. But then, 

1) went on to hide the really impor- 
tant advice (global variables) in typical 
and unnecessarily complicated C (for a 
“novice”) programming, and 
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New! DIG for WINDOWS! Save Time! 
Contour, Bar, Pie,X-Y, Log, Spherical & 3D Fishnet 
graphs are autoscaling. Dynamic 3D motion of 
models. Fast polygon fill. Write one routine to 
support CGA, BGA, VGA, Herc, PostScript & Dot 
Matrix, Laser, Plotters at full resolution. NO 
ROYALTY! For C, C++, QuickBASIC, BASIC, 
FORTRAN and Windows. Prices begin at $180! 


CHIRP TECHNICAL SERVICES 
Call For Details! (619)632-9510 


SCALasie FONTS 


EXCLUSIVE! Integrate the FastFont Typeface 
Manager object library into your application to 
add fast, WYSIWYG, on-the-fly printer and dis- 
play fonts. Includes the three most popular 
hinted font families. 300+ 

fonts available. Only $495 

with NO ROYALTIES. 


4 ot Optional Printer 
iN cy Driver Platform, Font 
“a Conversion Util- 
e SS ities, et al. 
SS Ancier 
¥ oe Technologies, Inc. 
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Carlsbad, CA 92008 
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pm GRAPHICS in your 
UNIX programming: 


VGA, EGA & Hercules 
UNIX PLOT(3) subroutines for 
SCO XENIX & UNIX, 386/ix, 
AT&T System V/386, VENIX 
Wi circles, rectangles, fills, 
user-defined shapes and more 


Wi Coded with integer arithmetic 
Hl One binary supports all 3 modes 
Most graphics cards supported 
$80 + $3 shippingMandling: single user 
$400 + $3 shipping/handling: developer 
Certified Scientific Software 
P.O. Box 802168 
Chicago, IL 60680 
312-247-2442 
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TCP/IP 


NETWORKING PROTOCOLS 
Add them to your System 
Designs with: 
FUSION Developer's Kit 

e FUSION TCP/IP protocol suite 


¢ Flexible architecture - C source 
code 
¢ Used in hundreds of process 
contro!, embedded systems, 
and end-user designs 
e Full support with consulting and 
porting services 
Call: 800-541-9508 
805-485-2700 
Fax: 805-485-8204 


= 
Ss Network Research 
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C++ Class Library 


For Class Designers 
Increase software development 
productivity by choosing from a 


wide variety of efficient, reusable, 
portable, extensible, and maintain- 
able classes. Source code, test 
suites and documentation in- 


cluded. 


$175.00 
Qualware 


(714) 259-1322 
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Printer Graphics Libraries 


PGL ToolKit is a set of casy to usc librarics 
for generating device independent high 
resolution printer graphics on most 
popular printers. Provides 80+ functions 
to create vector drawings and/or print 
bitmapped images. Provides full control 
of printing (margins, layout, sizc, resolu- 
tion, etc.) and supports parallel and 
serial port interfaces. Includes full sup- 
port for C/C++, FORTRAN, Pascal, 
Basic, Clipper, & Assembly plus 32-bit 
support for C and FORTRAN. 


NO ROYALTIES! 
Only $145 (includes all language support) 


AnSoft, Inc. 

8254 Stone Trail Court 
Laurel, Maryland 20723 USA 
Voice/FAX: (301) 470-2335 
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“Do not be fooled by the fact that this ts the 
least expensive of the five packages reviewed 
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John Rex, Computer Language 


“TLIB is a great system” J. Vallino, PC Tech J 


- Full-Featured Version Control for Software 
Professionals. Check-in/out locking. Branching. 
Keywords. Wildcard and list-of-file support. Can 
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MS-DOS $139, OS/2 $195 + shipping visa 
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BURTON SYSTEMS SOFTWARE 
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SEEING IS_ BELIEVING 
DocBROWSER 


DocBROWSER is a complete documentation 
system for C and PL/M programs, with printed 
reports on size, cullers, users, declarations and 
more plus hot-key access to a full featured 
browser interface for all source and include files. 
functions, data structures and comments. 

If you maintain programs, become an expert 
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any part of your Bei Ke ye 
y Pi y Pa USS Gg hee 


source with a single 
keystroke. 4 300 %, wr 


~ 
927 1481 “ANS 
oftware Environments 
P.O. Box 2129 
Ss Missian Vieja, CA 92690 
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Motif Developers 


User interface toolkit for 
Motif programmers. Set 
of widgets provide data 
byte specific field entry 
with value checking. 

Save 90% development 
time and difficulty. 

Circle reader service 

card for informative flyer. 


Marlan Software 
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C Object Programming 


The COP manual prescribes a coding 
style for incorporating objects into your 
ANS! C applications. COP objects pro- 
vide for encapsulation, single and multi- 
ple inheritance, polymorphism (virtual 
functions), and are extensible. Now you 
can port C++ OOP designed applica- 
tions to C. Includes DOS formatted 3.5” 
and 5.25" diskettes with header and 
source object templates, only $25 (add 
$10 foreign delivery). 


The Loose Data Binder, LDB v1.6, is a 
ANSI C persistent container object 
library written with COP. Includes 100+ 
page manual and diskettes with source 
(requires COP above), only $35, add $15 
for foreign delivery. 


PSW, P.O. Box 10072 
McLean, VA 22102-8072 USA 
(703) 759-3838 


+ Request 133 on Reader Service Card + 


Performance Protocols 


LAT™ XNS 
Telnet rlogin 


Portable C Libraries 
UNIX, VMS, DOS Ports 


Fast Implementation 
Fast Execution Speed 
Fast Time to Marker 


Call 314.532.7708 
Meridian 


TECItNOLOGY CORTORATION 
V1 McBride Corporate Center Drive 
Chaterfield, Missouri 63005-1406 


PROSYS — the Project Development Tool 


DOS programmers: 

Slash (ntesface development ume fur your next lext- 
mode “C" application, Complete interface develop. 
ment including cereena, menus, overlapping windows, 
contest tensilive HELP, report writing, and even pro- 
pram installation. 

Design ecreens and menus with our caty ta use Kercen 
painter. Add data VO fields to screens with automatic 
dala validation by internal of wer tupplied functions. 
Project reports simplify internala documentation. 
String externalization supported (foreign language 
support). Rapid project prototyping, wilh automatic 
structured code generation directly from the prototype. 
Hult in seamless security aytiem. 

Linkable libraries include (unctions to easily manage 
the user interface. One simple function call all it takes 
lo do sercen input, validate the fields, and request 
HELP. 

Price $99.95 complete. 

Microzoft® “C™ (ver $.0 or Liter) required. Specuy disk 
formal. $5.00 S&H. PA add 6%, No royalties. 30 Day 
moncy back if nat satisfied. Check, MO to: 


Killdeer Software, Suite 192 
4676 Broadway, Allentown, PA 18104 
215-434-4036 
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“AN unusual name for an unusual product. 
MITUI is @ eal of classes that corform ta the CUA stancard 
taking the hard work out of interlace Development.” 


Program Now (UK), October/31 
If your C-based sofiware development shoutd be... 


« Windows and OS/2's PM touk-alike and conforming 
to IBM's CUA/SAA standard; 


.. based on a small and high-level API made up by 
less than 70 functions (instead of aver SOU provided 
by the competition); 


... able to mun on every PC/MS-DOS-based computer 
(not just on fast 386s & 486s); 


.~ based on highest quality, 
portable tools, then you need 


MITUI 


The first high-level CUA APL® 


Availahle foc Borland and Mocroson C & C++ copiers frum. 
MBI - Mayer & Bunge Informatica Lida. 


Addeass: Catta Postal 22.201 /01498 Sao Pauls (SP) / BAAZL 
Phone/Fax: «(55) (11) 872-0497 Phone: «(55) (11) 672-4758 


Cbject coda anty: US$ 380; w2h sourca: USS 720, H&S included 
Na taxes, No royalties. Sand check of money order, of ask lor true 
info pack, Incud.ng pubfe demain MITUI Editor with source code. 
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Source code 


CD-ROM 


Over 500 megabytes of 
ree code chives. 

ousands of pro s, 
full source dode for 

utilities, programming 


tools, games, etc. 


$39.95 


PDQ Software 
1547 Palos Verdes Mall 
Suite 260 
Walnut Creek, CA 94596 
1-800-786-9907 
1-510-947-5996 
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2) omitted the bookkeeping: how 
docs TURBO C access this new 
library?. 

Comment 1: (Probably brought on 
by some 30 years of teaching) Why not 
keep it simple? Give the questioner a 
simple “Hello World” example that 
stresses library use by itself? 

Comment 2: This second comment is 
much more important and is the result 
of my telephone call to Borland: Where 
does one put his library so that Turbo C 
can find the functions contained in it? 
The ease with which one can write and 
save header files (in the same directory 
as other header files are saved in) 
would imply that personal libraries 
could be saved in the library directory. 
This is not the case. Turbo C is “hard 
wired” to search only the Borland-sup- 
plied libraries. Path(s) to users’ libraries 
must be supplied in make, or project 
files. 

(TLIB does allow you to add func- 
tions to (or modify) a current Borland 
library, but this could prove a dangerous 
thing to do.) 

Thus, when using the very con- 
venient IDE, every program that uses a 
non-Borland library must be a project, 
and a project file must be written! 

Access to your own library is not ex- 
plained where it should be (not in the 
Borland manuals, nor in the two classic 
Turbo C Bibles by Barkakati), nor can I 
find it in any of the many Turbo C 
books that I have compulsively bought. 
Only H. Schildt, in his Turbo C, The 
Complete Reference, Borland-Os- 
born/McGraw-Hill, gives this little gem 
of information. Even here, a confusing 
(and extraneous?) “T” is introduced. 

Indeed, this omission on the part of 
many authors who glibly write of 
generating one’s own library makes me 
wonder how many have ever done so? 

Owen Gailar 

Professor Emeritus, (Purdue University) 
345 W. San Carlos 

Fresno, CA 93704 


I have, and I had to learn all the 
things you and Ken summarized here. 
Thanks for the clarifications. — pjp 


Dear Mr. Piauger, 

I would like to respond to two items 
in the December CUJ. 

First, with regard to C. Skelly’s fas- 
cinating article, “Creating C+-+-Like 
Objects in C.” I believe Mr. Skelly made 
two important points that are worth 
reiterating. 

One, callback functions are the foun- 
dation of polymorphic behavior. Under- 
Standing this point makes it easier to 
design flexible systems in C. This point 
also clarifies a common misconception 
about C++. The virtual keyword is 
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32-bit Protected Mode 
386 C Graphics Library 


Intel 386/486 C Code Builder 
MetaWare, MicroWay, SVS, 
Watcom & Zortech with 
Phar Lap 386|ASM 
Mixed Raster/Vector, 
Scalable, Rotatable Font, 
VGA, SVGA, 8514/A, VESA, 
Hercules Graphics Station 
through 1024x768x256 (8-bit), 
640x480x32k (16-bit), 
512x480x16.7m (32-bit), 
WYSIWYG HP-GL/PostScript 
$200 NO ROYALTIES 
FULL SOURCE CODE 
Gary R. Olhoeft 
P.O. Box 10870 Edgemont 
Golden, CO 80401-0620 
303-877-3697 CIS 76665,2021 
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Opt-TECH Sort/MERGE 


Extremely fast Sort / Merge / 
Select utility. Run as an MS- 
DOS command or CALL as a 
subroutine. 

Supports most languages and 
filetypes including Btrieve and 
dBase. Unlimited filesizes, mul- 
tiple keys and much more! 


MS-DOS, Windows $149. 
OS/2, UNIX $249. 


Opt-Tech Data Processing 
P. O. Box 678 
Zephyr Cove. NV 89448 


(702) 588-3737 
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Development 
Utilities 


World's largest and best collections of 
PD/Shareware for PC pros extensively indexed and 
ZlPed for best value. 30 day guarantee. 
Visa/MC/AmEx/COD. Ship/H $5US,$20Forcign. 


Products = Ss Disk s/Files__ 
1-2-3 and compatibles 

Assembler 

C (Turbo & MS) 


C++ (subset of ubove) 
AutoCAD 

dBase & Compilers 
DOS (PC consultants) 
DTP (esp. Ventura) 
Netware 

Paradox 

PC Products Database 
Turbo Pascal 

Visual BASIC 
Windows 
WordPerfect 39/290 


EMS Professional Shareware 
4505 Buckhurst Ct.; Olney, MD 20832 
(301) 924-3594, Fax: (3013 963-2708 
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= The Window BOSS= 


The Window BOSS is a Windowing and 
Data Entry library for “C" compilers from 
Microsoft. Borland, Watcom, Zortech, 
Lattice, and MIX. It is small fast, power- 
ful, and uncluttered. The programmer 
interface is flexiable and easy to recall. 
Computer Language Magazine (9/91) 
ranked The BOSS as a low cost high end 
product with the best form-construction 
capabilities of all the products reviewed!! 
PC Resource, PCM, and other magazines 
have printed similar accolades. Best of all, 
The Window BOSS is shareware! Order 
your shareware copy from the user group 
or from Star Guidance. Order source 
code from Star Guidance. 

Star Guidance Consulting, Inc.- Waterbury, CT. 


(203) 574-2449 
Shareware:$20.00 MC/VISA/COD Source: $55.00 


> Request 163 on Reader Service Card + 


C Source Code 


QNU C++ - Includes C.....sccsesseee $135.00 
QU CMACS......cssrcssererssenceccenseee $120.00 
QNU C - 386 exe & DOS extender ..... $115.00 
GNU CG - SOUFCE OMY ...ressssssesseessntessneersneens $90.00 


pc/ip - tcp/ip, NFS & many drivers ..... $50.00 
gnu gdb - symbolic debugger ......... $45.00 
QNU Gawk - awk Clone .sesceerecesersoee $30.00 
gnu ghostscript - PS clone........++ $25.00 


gnu gas - as tor 80386, 68K, ate........ $25.00 
gnu binutils - td, ar, nm, etc. ...-..006. $25.00 
gnu bison and flex .........seeeeeee $25.00 
gnu tools - grep, tar, ditt, & res/evs... $25.00 
gnu fileutils - Is, my, cp, etc. ...-..00 $25.00 
PCcurses + libs - Turbo & MSC.... $25.00 

babe $25.00 


RCS - Reviston Contro) System ue 
Diff and Grep........-ssceseseees ee 


DOS or CPIO e wloltak 0 


VISA/Master Card 

Add $4 for COD 23 Cornwall Road 
US Postage Paid Freehold, NJ 07728 
Add $10 for Next Day (908) 206-0320 Voice 
Forsign Add 5% 908) 303-9364 FAX 
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Learn C 


Our C tutorial uses a unique method to teach 
you to program in this modern language. 
There are about 80 source files, on disk, 
which you study, then compile and execute 
to loam all aspects of ANSI-C. 


Learn C++ 


Once you know C, you can go on to learn 
the newer constructs of C++. Our C++ 
tutorial teaches you "why" you should use 


object-oriented programming in addition to 
*how’ to use it 


Each MS-DOS tutorial is $39.95 + $3.00 P&H 
(in US). M/C or Visa accepted. Other lan- 
guage tutorials are available also. 


Coronado Enterprises 


12501 Coronado Ave. NE 
Albuquerque, NM 87122 


(505) 293-5464 


~ Request 273 on Reader Service Card + 


may WindowsCreator gy 


revolution !!! 


* create WINDOWS interactively 

¢no need to write any code 

¢ You PAINT the application, not write!!! 

* object-oriented programming using 
standard C language 

¢ Generated C-code or Smalltalk code 
in secondsl! 

¢ Dialog, window, menu, cursor, 
icon, color, brush and attrib. 
editors incl. 

¢ interactive functionality linking 

¢ application code is separated from 
interface code. Few code lines connect 
application to WINDOWS interface 


AdamSoft, 66 rue de Bourgogne 
L-1272 Luxembourg 
Fax:+352-494768 VISA accepted 
Until April 30th — $200, after $299 
p&p Europe $10, elsewhere $20 
+ Request 146 on Reader Service Card + 


BGI GRAPHICS 
PC TIMER TOOLS 


BGI Printer Driver Toolkit 
Now you can effortlessly add high resolution hardcopy 
to your BGI graphics routines with BGI drivers for 
Epson, Proprinter, LaserJel, DeskJet, PaintJet, Post- 
script, and others. Supports TC, TC++, BC++, TP. 
Complete driver source code included. $89.95 


BG! For Windows 


Port your BG! graphics coda to Windows with our new 
BGI compatible graphics interlace for Windows 3.x. 
Each window is a completa BG! environment with 
stroke font and hardcopy support. Supports BC++, 
TCW, TPW. Full sourca code includad. 389.95 


PC Timer Tools 
High resolution timing, delay, profiling, timer tick mg}., 
and scheduling funcions. Supports TC, TC++, BC++, 
MSC, TP, Intel 386 Code Builder, and Zorech C++. 
$69.95 with sauroe. 
PC Timer Objects 

OOP version of PC Timer Tools tor TC++, BC++, TP, 
and Zanech C++. $69.95 wilh source. 


Add S4 each shipping USA, $7 each elsewhere. 
VISA & MC are welcome. Our 30 day “No Questions 
Asked" retum policy assures your satistaction. 

Ryle Design Furveyors of Big Saence 
PO Box 22, Mt. Pleasant Michigan 48804 
Voice/Fax: $17.773.0587 BBS: 517.772.2393 
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April 1992 


Hire a Marketing Pro 
for $87 a year! as 


Get practical answers ta 
your tough marketing questions. 

The Inside Thic, a bimonthly interactive news- 
letter from The Trachtman Group, Inc. helps 
software companies aavigate through the maze of 
marketing issues confronting product launches 
@ Leam how to fund your madeting program with 

initial direct and OEM sales 
@ Find out how you can intelligently set the price 

of your new product 
8 Discover how to get noticed in an increasingly 
crowded markt. 

The Inside Trac includes membership to an 
interactive bulletin board where you can share 
ideas wath others trying to launch their products 
and get answers to your specific questions 


CALL 800-659-7420 Jor jour first 
nowbligation issue FREF 4v7 

The Trachtman Group, Inc. 

Successful Marketing of PC Software for aver 10 years 
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C++ Multitasking 
Class Library 


Now you can inherit the 
power of OBX™ Task Class 


Serious developers REUSE 
to get a multitasking 
prototype fast! 


See how easy multitasking 
can be: call for our 
ShellVision™ source code 


demo, you'll understand. 
Supports Borland. Source avaiable. 


C:mnapse 


11 Laurer, Suite 102, 
|: :obx| Chambly, QC, Canada J3L 5S3 
(614) 447-7221 Fax: (614) 447-7297 


PostScript TSRs — Under 9K 
PSFX. TSR prints Pos+Scrirr out- 
pur, just as formatted for Epson or IBM 
ProPrinter. See graphics, fonts, accents 
and boxes! Choose portrait or landscape, 
sizes up to LIXL7. Print one or two 
pages per sheet. Use with databases, 
accounting, PrtSc key. $85 
PSFXnet Novell NetWare version 
adds banner pages. Keeps statistics on 
pages printed by each userID. $99 
EPScreen Capwures PC sereens as 
tiny Encapsulated Pos Scriv't (EPS) 
files (3K), frames & TIFF optional. 
Mlustracions for manuals. Font included. 
Color files less than 10 K. $95 
Legend Communications, Inc. 
54 Rosedale Avenue West 
Brampton. ON, Canada L6X IKI 
30 day guarantee 

(800)668-7077 (416)450-1010 
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Why you want BATCOM! | 
BATCOM Is a batch file compiler! 
that compiles your “bat” files to 
“oxe" filos to make them faster, more 
professional, and more  capa- 
ble. BATCOM extends DOS with new 
commands so you can read keyboard 
Input, perform arithmetic, use subrou- 
tInes, and much more all fram within 
compiled batch files. In addition to 
speeding your batch files and adding 
new commands, BATCOM protects 
your source code, and you can dis- 
tribute your compiled programs with 
no royalties. For IBM PC. $59.95. 
/_N, Wenham Software Co. 

tT e | 65 Burley St. 

\_Z Wenham, Ma. 01084 
(508)-774-7036 
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Z-PHIGS” 


Use the power of most advanced graphics 
development system available today. 


Z-PHIGS is an enhanced implementation of the only 
recognized 3D-graphics standard PHIGS+ for DOS 
and Windows. It provides everything needed to de- 
velop high-performance graphics applications. A 
powerful library with 2D/3D functions and a highly 
optimized data management system save you years of 
development time in the fields of CAD/CAM, Simu- 
lation, Multimedia, etc. Most sophisticated rendering | 
capabilities like Lighting, Shading, Reflections. Tex- | 
ture-Mapping. etc. makes it simple and quick to give | 
your Windows products those spectacular 3D-graph- | 
ics features that will put your compititions to shame. | 
Language bindings are available for Pascal or C. 


For DOS $795, for Windows $1590 
VISA and MasterCard accepted. 


WISE Software, Scelandstr3, 2400 Lubeck 14, Germany 


' 
| 
' 
| 
\ 
| 
Tel: (+49) 451-3909413 Fax: (+49) 451-3909-499 | 
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'C’ and "C++" DOCUMENTATION TOOLS 


| AUTOMATED DOCUMENTATION | 


» C-CALL ($59) Creates a graphic-tree of 
the caller/called functions, and creates 
a files-vs-functions table of contents. 

+ C-CMT ($59) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

+ C-METRIC ($49) new! Calculates the path 
‘cyclomatic’ complexity of functions, counts 
lines of Comments, Code, 'C' statements. 

+ C-LIST ($49) Lists and action-diagrams, 
or reformats source into standard formats. 


+ C-REF ($49) Creates cross-reference of 
local/globai/define/parameter identifiers. 


* SPECIAL OFFER ($189) AllS programs, 
fully integrated as C-DOC DOS program, 
plus free OS/2 protected-mode program. 


+ 30-DAY Money-back guarantee CALL NOW 
SOFTWARE BLACKSMITHS INC. 
6064 St lves Way, Mississauga 
ONT, nad IN 4 


nada Mi 5 


See AD INDEX for our larger ad 
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not free, There is an overhead as- 
sociated with using virtual functions, 
which is exactly the overhead of the call 
by address mechanism. 

Two well-constructed C libraries use 
subject-predicate naming conventions, 
instead of the more natural seeming 
predicate-subject. For example, Circle- 
Draw() is correct, DrawCircle() is in- 
correct. Having our function names sort 
on the object name Circle allows us to 
associate the functionality of the Circle 
Structure with those functions that begin 
with that name. This system also has the 
nice property of sorting well in the sym- 
bol tables. 

The second point I wish to address 
refers to Jack Purdum's letter on the 
define versus declare problem. I am 
surprised you don't get it. Stating a 
thing twice doubles the amount of work 
needed to maintain it. Any symbol addi- 
tion in Mr. Purdum’s example requires 
one source code modification, as op- 
posed to the usual two. This problem 
occurs in a lot of places. Preprocessor 
tricks, which are all variations on the 
one given, can save days of hard boring 
labor in the course of a large project. 

Sincerely, 
Adam Greissman, President 
Hermeios, Inc. 
853 Broadway, Suite 1104 
New York, NY 10003 


I see both advantages and disad- 
vantages in SubjectPredicate naming. I 
see both advantages and disadvantages in 
macros that let you declare a data object 
just once. That makes it hard for me to 
characterize any of these approaches as 
“right” or “wrong.” —pjp 


Dear Mr. Plauger: 

I would like to request an article dis- 
cussing the NCEG extensions to Stand- 
ard C be published. In addition, perhaps 
several articles discussing issues regard- 
ing their use. 

As an avid reader of your column, I 
would like to know your opinions 
regarding text formatting packages, 
especially regarding nroff/troff versus 
the current crop of desktop publishing 
packages. Would you care to clarify it in 
an upcoming column? 

Thanks for your help. 


Sincerely, Wen J. Chen 


143-25 41st Avenue, #340 
Flushing, NY 11355 


I haven't discussed NCEG issues in 
my column yet for two reasons. First, I 
still have a few more installments on the 
Standard C library. Second, the NCEG 
folk are still settling down on the content 
of their technical report. I fully expect to 
devote some space to their work at the ap- 
propriate time. — pjp 
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TURN A PC INTO A POWERFUL 
SERIAL COMMUNICATIONS 
PROTOCOL ANALYZER 


~ “CEIMe - 
v1 VERSION 1,01 

A $395. 
THE B VERSION 2.0 


FEATURES $790.0 
& PERFORMANCE OF AN ea 
EXPENSIVE HARDWARE ANALYZER / ‘(> < 
AT A FRACTION OF THE COST... 

PLUS YOU CAN CREATE CUSTOM 
CAPTURE & ANALYSIS PROGRAMS ‘1 8; 
WITH OUR BUILT IN EDITOR & a ei 
"C”" COMPILER 


© Use standard COMI / COM2 
NO special cables required 

* psecond liming accuracy 

* Easy la use menus & 
user defined windows 

* Data To & From disk 

* Capture & Transmit 
in both directions 

* SYNC or ASYNC 


REALTIME 
CONTROL, INC 
(904) 373-2626 
(800) 232-0485 
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Stylus 


Read existing C source code into structure chart 
form (machine readable NS) 

Create and/or maintain code at the Nassi 
Shneiderman chart level (no more braces} 
Automatically translate NS charts back into conven- 
tional C sourca for compilation 

Runs under DOS and OS/2 full screen mode with 
extensive help facilities 

$295.00 indudes 1st dass shipping. Checks, Visa, 
American Express and Mastercard accepted. 


Stylus Software 


144 Two Appleuee Square 
Minneapolis MN 55425-1637 


Tel: (612)-854-5800 FAX: (612)-854-6948 
Toll Free: 1-800-245-2575 
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FLOATING POINT 
ARRAY PROCESSOR 


Operates aon Arrays & Matrices: 
Integer, Real, & Complex Structures. 
Process math-intensive algorithms 
100 times faster than the 80387. 
598 mathematic & scientific functians 
on-board In EPROM, callable from C, 
Private high speed STATIC memary 


(0.25 to 4.25 magabytes) on board. 
3 megabytes/sac to/from ISA host. 
Diract hardware link to video & A/Ds. 
1000 page referance manual. 
$2495.00 complete with software. 
Call for function list and banchmarks. 


Eighteen Eight Laboratories 
1-800-888-1119 FAX 702-294-2611 
1247 Tamarisk Lane 
Boulder City, NV 89005 
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Installation 
Made Easy 


The Stork 


Automatic Installation Utility 
Easy to use WYSIWYG design system walks 
you through each step of the installation 
process, Using mouse or keybourd, you creale 
a customized installation procedure as you 
interact with cach design tool. Extensive 
built-in error checking in the installation 
procedure as well as in the design system gives. 
you confidence that the procedure is accurate 
and bullet-proof when used by your customer. 

“This product has proved invaluable for both 

simple and complex installation procedures.” 


The Stork Delivers $175 
(No risk 30 day guarantee) 
ea, as 
@ \sland Systems 


7 Mountain Ad. Burlington MA 01803 
(617)273-0421 Fax (617)270-4437 
MasterCard & VISA accepted 
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DEVELOPERS! 
AECGEAOMEP! 


GOING INTERNATIONAL? 


Our string extemalization utilities and C 
functions can help you get your package ready 
for the intemational market. 

These proven utilities extract literal strings 
from your C source code, ready for editing, 
translation or encryption, without impacting 
your original executable. While saving scarce 
initialized data space, these functions allow 
your easily re-defined prompts to behave as if 
they were compiled directly into your program. 
This permits the original executable to "speak" 
the language of your choice, even Japanese! 

Includes all object/source code and libraries 
for popular C compilers. Price $149.95 for ob- 
ject, $249.95 for source code site license. No 
royalties. DOS, Unix, Mac, etc. VA residents 
ad sales tax. 


Network Dynamics, Inc. 
2225 S. Henry Street, Suite L-2 
Williamsburg, VA 23185 
Phone (804) 220-8771 Fax (804) 220-5741 
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32482 


34732 
35007 

8092 
22824 
12842 
39148 
16785 
27096 
15523 
33045 


Customer No. 


Last Name 


Customer Browse 


=| 
=| Modify Find Select Bottom Top Go 


First Name | Customer Edit 


Modify Find Select Bottom Jop Go Help 
Stickle Jim 
[Stickel [Ron 
Stice Yern Customer No. 
Stevenson Alan 
Steward 2 Last Name 
Stewardsor 
Stewart 
Stewin Search On: Search Value: 
Steyn 
Sthankiya Cust. No. 
Stiansen First Name 


Stickley 


Call for 4 
FREE 


Bro se =e) 
UTIILY- 


e Multi User 


¢ Portable (DOS, Unix, ...) 
¢ Royalty Free DLL 


Last Name 


Design CodeBase 
Browse/Edit screens using 
any resource toolkit. 


Use CodeBase 4.5 from Visual Basic 
or Turbo Pascal for Windows. 


Use the super-fast, super-small FoxPro 2.0 
CDX or the Clipper NTX index files. 


" Our product was too slow under FoxPro 2.0, 


so we rewrote it in C using CodeBase. Now 


e C++ interface included itis incredibly fast.” 
Jeff Reed, DCS Computer Services 


CocleBbase 4.5 


The C Library for DataBase oo 


SEQUITER fff EE}: $88:43772439 
SOFTWARE INC. Europe 33.20. a See 
#209,9644-54 AVE., EDMONTON, AB, CANADA TeE-5v4 5V1 


© 1991 Sequiter Software Inc. 
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Graphics by Micra.Arts. 1991 


Shak wi" e Breet ery | ae cone as la Oo Pees 


LAN PLUS 


| 


| | 


\ MULTI; CLIENT/ FAIRCOM 
\\ USER SERVER — SERVERS 


\ 


@ Use c-tree Plus as a data management engine, or as a front-end to the FairCom 
Server or FairCom SQL Server! 

Now you don't have to choose between different application configurations — c-tree Plus 
supports them all! You can use c-tree Plus to create single user, multi-user, or LAN applications, 
and easily adapt them to utilize the advanced client/server technology of 
FairCom Server or FairCom SOL Server, (which offers full ANSI-standard SOL 
functionality). 


1 c-tree Plus offers complete scalability! 
No matter what kind of platform you're running on (or moving to), c-tree 
wus eliminates the tedious, time-consuming reprogramming normally 
required to move from one environment to another. With c-tree Plus, you 
don't change your source code at all — just recompile, link, and you're run- 
ning on platforms ranging from Cray supercomputers to Zenith laptops! 


B With the FairCom Servers, c-tree Plus offers powerful (and afford- 
able) transaction processing capabilities! 

Using c-tree Plus as a front-end to the FairCom Servers, you can incorpo- 
rate powerful transaction processing features directly into your applications, 
including full commit/rollback, intermediate savepoints and complete 
logging. 

@ Order c-tree Plus, and put yourself in the driver's seat! 
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Whether you currently need the power of client/server technology, or just 
need the most powertul data management system around, c-tree Plus is for you — order your 


copy today! 


(800) 234-8180, Ext. 1 
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